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Preface 


his book is an introduction to object-oriented programming using the Java 
programming language. We use the object-first approach where objects are used 
from the first sample program. Object-oriented thinking is emphasized and pro¬ 
moted from the beginning. Students learn how to use objects first and then learn 
how to define their own objects. 


Key Changes in the 5th Edition 

The key differences between this edition and the fourth edition are as follows: 

1. More Discussion on Java 5.0 Features and Java 6.0 Compatibility. Many 
of the new Java 5.0 features are explained and used in the sample programs. 
They include the enumerator type, the for-each loop construct, auto boxing 
and unboxing, and the generics. 

2. Exclusive Use of Console Input and Output. All the GUI related topics, 
including the JOptionPane class, are moved to Chapter 14. Sample programs 
before Chapter 14 use the standard console input (Scanner) and output 
(System.out). Those who want to use JOptionPane for simple input and output 
can do so easily by covering Section 14.1 before Chapter 3. 

3. More Examples from Natural Sciences. In several key chapters, we illus¬ 
trate concepts using examples from biology and chemistry. For example, in 
Chapter 4, we use the elements in the periodic table to illustrate the concept of 
programmer-defined classes. In Chapter 9, we demonstrate how the string 
processing techniques are applied to implement DNA sequencing and other 
common DNA operations. 

4. Level-by-level Organization for Programming Exercises. Programming 
exercises at the end of chapters are organized into three levels of difficulties. 
The one-star level exercises require the basic understanding of the materials 
covered in the chapter. The two-star level exercises require some additional 
thinking beyond the basic understanding. The three-star level exercises are 


xi 
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most difficult and require significant effort. For some of the three-star exer¬ 
cises, students must find or study additional information beyond those pre¬ 
sented in the book. Please keep in mind that the level of difficulties is only a 
general guideline. One student may find some level-three exercises much eas¬ 
ier than level-two exercises, for example. 

Book Organization 

There are 16 chapters in this book, numbered from 0 to 15. The first 11 chapters 
cover the core topics that provide the fundamentals of programming. Chapters 11 to 
15 cover intermediate-level topics such as sorting, searching, recursion, inheritance, 
polymorphism, and file I/O. There are more than enough topics for one semester. 
After the first 11 chapters (Ch 0 to Ch 10), instructors can mix and match materials 
from Chapters 11 to 15 to suit their needs. We first show the dependency relation¬ 
ships among the chapters and then provide a brief summary of each chapter. 

Chapter Dependency 

For the most part, chapters should be read in sequence, but some variations are 
possible, especially with the optional chapters. Here’s a simplified dependency 
graph: 


0 

1 

1 

1 

2 

1 

3 

I 

4 

I 

5 

1 

6 
7 



8 9 10 



*Note: Some examples use arrays, 


11 12 13 14*15 but the use of arrays is not an 


integral part of the examples. 
These examples can be modified 
to those that do not use arrays. 
Many topics from the early part 
of the chapter can be introduced 
as early as after Chapter 2. 
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Brief Chapter Summary 

Here is a short description of each chapter: 

• Chapter 0 is an optional chapter. We provide background information on 
computers and programming languages. This chapter can be skipped or as¬ 
signed as an outside reading if you wish to start with object-oriented pro¬ 
gramming concepts. 

• Chapter 1 provides a conceptual foundation of object-oriented programming. 
We describe the key components of object-oriented programming and illus¬ 
trate each concept with a diagrammatic notation using UML. 

• Chapter 2 covers the basics of Java programming and the process of editing, 
compiling, and running a program. From the first sample program presented in 
this chapter, we emphasize object-orientation. We will introduce the standard 
classes String, Date, and SimpleDateFormat so we can reinforce the notion of 
object declaration, creation, and usage. Moreover, by using these standard 
classes, students can immediately start writing practical programs. We describe 
and illustrate console input with System.in and the Scanner class and output with 
System.out. 

• Chapter 3 introduces variables, constants, and expressions for manipulating 
numerical data. We explain the standard Math class from java.lang and 
introduce more standard classes (GregorianCalendar and DecimalFormat) to 
continually reinforce the notion of object-orientation. We describe additional 
methods of the Scanner class to input numerical values. Random number 
generation is introduced in this chapter. The optional section explains how the 
numerical values are represented in memory space. 

• Chapter 4 teaches the basics of creating programmer-defined classes. We 
keep the chapter accessible by introducting only the fundamentals with illus¬ 
trative examples. The key topics covered in this chapter are constructors, vis¬ 
ibility modifiers (public and private), local variables, and passing data to 
methods. We provide easy-to-grasp illustrations that capture the essence of 
the topics so the students will have a clear understanding of them. 

• Chapter 5 explains the selection statements if and switch. We cover boolean 
expressions and nested-if statements. We explain how objects are compared 
by using equivalence (==) and equality (the equals and compareTo methods). 
We use the String and the programmer-defined Fraction classes to make the 
distinction between the equivalence and equality clear. Drawing 2-D graphics 
is introduced, and a screensaver sample development program is developed. 
We describe the Java 5.0 feature called enumerated type in this chapter. 

• Chapter 6 explains the repetition statements while, do-while, and for. Pitfalls 
in writing repetition statements are explained. One of the pitfalls to avoid is 
the use of float or double for the data type of a counter variable. We illustrate 
this pitfall by showing a code that will result in infinite loop. Finding the great¬ 
est common divisor of two integers is used as an example of a nontrivial loop 
statement. We show the difference between the straightforward (brute-force) 
and the clever (Euclid’s) solutions. We introduce the Formatter class and show 
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how the output can be aligned nicely. The optional last section of the chapter 
introduces recursion as another technique for repetition. The recursive version 
of a method that finds the greatest common divisor of two integers is given. 

Chapter 7 is the second part of creating programmer-defined classes. We 
introduce new topics related to the creation of programmer-defined classes 
and also repeat some of the topics covered in Chapter 4 in more depth. The 
key topics covered in this chapter are method overloading, the reserved 
word this, class methods and variables, returning an object from a method, 
and pass-by-value parameter passing. As in Chapter 4, we provide many 
lucid illustrations to make these topics accessible to beginners. We use the 
Fraction class to illustrate many of these topics, such as the use of this and 
class methods. The complete definition of the Fraction class is presented in 
this chapter. 

Chapter 8 teaches exception handling and assertions. The focus of this chap¬ 
ter is the construction of reliable programs. We provide a detailed coverage of 
exception handling in this chapter. We introduce an assertion and show how it 
can be used to improve the reliability of finished products by catching logical 
errors early in the development. 

Chapter 9 covers nonnumerical data types: characters and strings. Both the 
String and StringBuffer classes are explained in the chapter. Another string 
class named StringBuilder is briefly explained in this chapter. An important ap¬ 
plication of string processing is pattern matching. We describe pattern match¬ 
ing and regular expression in this chapter. We introduce the Pattern and 
Matcher classes and show how they are used in pattern matching. One section 
is added to discuss the application of string processing in bioinformatics. 
Chapter 10 teaches arrays. We cover arrays of primitive data types and of ob¬ 
jects. An array is a reference data type in Java, and we show how arrays are 
passed to methods. We describe how to process two-dimensional arrays and 
explain that a two-dimensional array is really an array of arrays in Java. Lists 
and maps are introduced as a more general and flexible way to maintain a col¬ 
lection of data. The use of ArrayList and FlashMap classes from the java.util 
package is shown in the sample programs. Also, we show how the Word List 
helper class used in Chapter 9 sample development program is implemented 
with another map class called TreeMap. 

Chapter 11 presents searching and sorting algorithms. Both N 2 and MogiA 
sorting algorithms are covered. The mathematical analysis of searching and 
sorting algorithms can be omitted depending on the students’ background. 
Chapter 12 explains the hie I/O. Standard classes such as File and JFile- 
Chooser are explained. We cover all types of hie I/O, from a low-level byte 
I/O to a high-level object I/O. We show how the hie I/O techniques are used 
to implement the helper classes —Dorm and FileManager— in Chapter 8 and 9 
sample development programs. The use of the Scanner class for inputting data 
from a texthle is also illustrated in this chapter. 
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XV 


Chapter 13 discusses inheritance and polymorphism and how to use them ef¬ 
fectively in program design. The effect of inheritance for member accessibil¬ 
ity and constructors is explained. We also explain the purpose of abstract 
classes and abstract methods. 

Chapter 14 covers GUI and event-driven programming. Only the Swing- 
based GUI components are covered in this chapter. We show how to use the 
JOptionPane class for a very simple GUI-based input and output. GUI com¬ 
ponents introduced in this chapter include JButton, JLabel, Imagelcon, 
JTextField, JTextArea, and menu-related classes. We describe the effective use 
of nested panels and layout managers. Handling of mouse events is described 
and illustrated in the sample programs. Those who do not teach GUI can skip 
this chapter altogether. Those who teach GUI can introduce the beginning part 
of the chapter as early as after Chapter 2. 

Chapter 15 covers recursion. Because we want to show the examples where 
the use of recursion really shines, we did not include any recursive algorithm 
(other than those used for explanation purposes) that really should be written 
nonrecursively. 
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Hallmark Features of the Text 


Problem Solving 


2.5 Sample Development 


Printing the Initials 

Now that we have acquired a basic understanding of Java application programs, let's 
write a new application. We will go through the design, coding, and testing phases of the 
software life cycle to illustrate the development process. Since the program we develop 
here is very simple, we can write it without really going through the phases. However, it is 
extremely important for you to get into a habit of developing a program by following the 
software life cycle stages. Small programs can be developed in a haphazard manner, but 
not large programs. We will teach you the development process with small programs first, 
so you will be ready to use it to create large programs later. 

We will develop this program by using an incremental development technique, 
which will develop the program in small incremental steps. We start out with a bare- 
bones program and gradually build up the program by adding more and more code to 
it. At each incremental step, we design, code, and test the program before moving on 
to the next step. This methodical development of a program allows us to focus our at¬ 
tention on a single task at each step, and this reduces the chance of introducing errors 
into the program. 

Problem Statement 

We start our development with a problem statement. The problem statement for our 
sample programs will be short, ranging from a sentence to a paragraph, but the problem 
statement for complex and advanced applications may contain many pages. Here's the 
problem statement for this sample development exercise: 

Write an application that asks for the user's first, middle, and last names and 

replies with the user's initials. 


Sample Development Programs 

Most chapters include a sample development 
section that describes the process of 
incremental development. 


Overall Plan 

Our first task is to map out the overall plan for development. We will identify classes nec¬ 
essary for the program and the steps we will follow to implement the program. We begin 
with the outline of program logic. For a simple program such as this one, it is kind of 
obvious; but to practice the incremental development, let's put down the outline of pro¬ 
gram flow explicitly. We can express the program flow as having three tasks: 

1. Get the user's first, middle, and last names. 

2. Extract the initials to formulate the monogram. 


Level-by-level Organization for 
Programming Exercises 


program 


3. Output the monogram. 

Having identified the three major tasks of the progra 
classes we can use to implement the three tasks. First, w< 
the input. At this point, we have learned about only the Sc« 
here. Second, we need an object to display the result. Again 
it is the only one we know at this point for displaying a 


Development Exercises 

For the following exercises, use the incremental development methodology to 
implement the program. For each exercise, identify the program tasks, create 
a design document with class descriptions, and draw the program diagram. 

Map out the development steps at the start. Present any design alternatives and 
justify your selection. Be sure to perform adequate testing at the end of each 
development step. 

11. In the sample development, we developed the user module of the keyless 
entry system. For this exercise, implement the administrative module that 
allows the system administrator to add and delete Resident objects and 
modify information on existing Resident objects. The module will also allow 
the user to open a list from a file and save the list to a file. Is it proper to 
implement the administrative module by using one class? Wouldn’t it be 

a better design if we used multiple classes with each class doing a single, 
well-defined task? 

12. Write an application that maintains die membership lists of five social clubs 
in a dormitory. The five social clubs are die Computer Science Club, Biology 
Club, Billiard Club, No Sleep Club, and Wine Tasting Club. Use the Dorm 
class to manage the membership lists. Members of the social clubs are 
Resident objects of die dorm. Use a separate file to store die membership 
list for each club. Allow the user to add, delete, and modify members of 
each club. 


Level 1 Programming Exercises ★ 

5. In the RollDice program, we created three Die objects and rolled them once. 
Rewrite the program so you will create only one Die object and roll it three 
times. 

6. Write a program that computes the total ticket sales of a concert. There are 
three types of seatings: A, B, and C. The program accepts the number of 
tickets sold and the price of a ticket for each of the three types of seats. The 
total sales are computed as follows: 

totalSales = numberOfA_Seats * pricePerA_Seat + 

numberOfB_Seats * pricePerB_Seat + 
numberOfC_Seats * pricePerC_Seat; 

Write this program, using only one class, the main class of the program. 
Define a new class named Temperature. The class has two accessors—to- 
Fahrenheit and toCelsius—that return the temperature in the specified unit 
and two mutators—setFahrenheit and setCelsius—that assign the temperature 
in the specified unit. Maintain the temperature internally in degrees Fahrenheit. 
Using this class, write a program that inputs temperature in degrees 
Fahrenheit and outputs the temperature in equivalent degrees Celsius. 


Development Exercises 

give students an opportunity 
to practice incremental 
development. 
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XVII 


Object-Oriented Approach 

We take the object-first approach to teaching object-oriented programming with emphasis 
on proper object-oriented design. The concept of objects is clearly illustrated from the very 
first sample program. 



Good practices on 
object-oriented design 
are discussed 
throughout the book 
and illustrated through 
numerous sample 
programs. 
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Illustrative Diagrams 

Illustrative diagrams are used to explain all key concepts of programming such as the 
difference between object declaration and creation, the distinction between the primitive 
data type and the reference data type, the call-by-value parameter passing, inheritance, and 
many others. 



Lucid diagrams are used effectively to explain 
data structures and abstract data types. 






0 12 3 4 5 



Figure 10.16 How a new array that is 150 percent of the original array is created. The size of the 
original array is 4. 
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XIX 


Student Pedagogy 


sr 

Always define a constructor and initialize data members fully in the 
constructor so an object will be created in a valid state. 



Design Guidelines 

provide tips on good 
program design. 


Things to Remember 

boxes provide tips for 
students to remember key 
concepts. 




ings to Remember 


List the catch blocks in the order of specialized to more general exception classes. 
At most one catch block is executed, and all other catch blocks are ignored. 



Hints, 


It is not necessary to create an object for every variable we use. Many novice pro¬ 
grammers often make this mistake. For example, we write 

Fraction fl, f2; 

fl = new Fraction (24, 36); 

f2 = fl.simplify( ); 

We didn't write 

Fraction fl, f2; 

fl = new Fraction(24, 36); 

f2 = new Fraction (1, 1); //not necessary 

f2 = fl.simplify( ); 

because it is not necessary.The simplify method returns a Fraction object, and in 
the calling program, all we need is a name we can use to refer to this returned 
Fraction object. Don't forget that the object name (variable) and the actual object 
instance are two separate things. 


Tips, Hints, and Pitfalls 

provide important points 
for which to watch out. 


You Might Want to Know 

q \ou 

boxes give students 

y Might 
Want to 

interesting bits of 

Know 

information. 

# 


We can turn our simulation program into a real one by replacing the Door class 
with a class that actually controls the door. Java provides a mechanism called Java 
Native Interface (JNI) which can be used to embed a link to a low-level device dri¬ 
ver code, so calling the open method actually unlocks the door. 


Quick 

CHECK 

V 


1. What will be displayed on the console window when the following code is 
executed and the user enters abc123 and 14? 

Scanner scanner = new Scanner (System.in) ; 

try { 

int numl = scanner.nextInt () ; 

System.out.printIn ("Input 1 accepted"); 
int num2 = scanner.nextlnt () ; 

System.out.println (" Input 2 accepted"); 

} catch (InputMismatchException e) { 

System.out.println ( " Invalid Entry" ) ; 

1 


Quick Check 

exercises at the end of 
the sections allow 
students to test their 
comprehension of 
topics. 
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Supplements for Instructors and Students 

The book is supported by a rich array of supplements available through the text’s 
website located at www.mhhe.com/wu 

For Instructors, a complete set of PowerPoints, solutions to the chapter exercises, 
and other resources are provided. 

For Students, source code for all example programs, answers to Quick Check 
exercises, and other resources are provided, as well as the optional galapagos pack¬ 
age, which includes the Turtle class that is necessary in solving various chapter 
exercises. 
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Introduction to 
Computers and 
Programming Languages 


After you have read and studied this chapter,you 
should be able to 

• State briefly a history of computers. 

• Name and describe five major components of 
the computer. 

• Convert binary numbers to decimal numbers 
and vice versa. 

• State the difference between the low-level and 
high-level programming languages. 




2 


Chapter 0 Introduction to Computers and Programming Languages 


Introduction 


efore we embark on our study of computer programming, we will present some 
background information on computers and programming languages in this optional 
chapter. We provide a brief history of computers from the early days to present and 
describe the components found in today's computers. We also present a brief history 
of programming languages from low-level machine languages to today's object- 
oriented languages. 



Charles 

Babbage 


Difference 

Engine 


Analytical 

Engine 


Ada Lovelace 


0.1 


A History of Computers 


Humans have evolved from a primitive to a highly advanced society by continually 
inventing tools. Stone tools, gunpowder, wheels, and other inventions have changed 
the lives of humans dramatically. In recent history, the computer is arguably the 
most important invention. In today's highly advanced society, computers affect our 
lives 24 hours a day: Class schedules are formulated by computers, student records 
are maintained by computers, exams are graded by computers, dorm security sys¬ 
tems are monitored by computers, and numerous other functions that affect us are 
controlled by computers. 

Although the first true computer was invented in the 1940s, the concept of a 
computer is actually more than 160 years old. Charles Babbage is credited with 
inventing a precursor to the modern computer. In 1823 he received a grant from 
the British government to build a mechanical device he called the Difference 
Engine, intended for computing and printing mathematical tables. The device was 
based on rotating wheels and was operated by a single crank. Unfortunately, the 
technology of the time was not advanced enough to build the device. He ran into 
difficulties and eventually abandoned the project. 

But an even more grandiose scheme was already with him. Infact, one of the 
reasons he gave up on the D i fference Engine may have been to work on hi s new con¬ 
cept for a better machine. He called his new device the Analytical Engine. This 
device, too, was never built. His second device also was ahead of its time; the tech¬ 
nology did not yet exist to make the device a reality. Although never built, the Ana¬ 
lytical Engine was a remarkable achievement because its design was essentially 
based on the same fundamental principles of the modern computer. One principle 
that stands out was its programmabi lity. With the D ifference E ngi ne, B abbage woul d 
have been able to compute only mathematical tables, but with the Analytical Engine 
he would have been able to compute any calculation by inputting instructions on 
punch cards. The method of inputting programs to computers on punch cards was 
actually adopted for real machines and was still in wide use as late as the 1970s. 

The Analytical Engine was never built, but a demonstration program was 
written by Ada Lovelace, a daughter of the poet Lord Byron. The programming lan¬ 
guage Ada was named in honor of Lady Lovelace, the first computer programmer. 

In the late 1930s John Atanasoff of Iowa State U niversity, with his graduate 
student Clifford Berry, built the prototype of the first automatic electronic calculator. 
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computers 


0 ne i nnovation of thei r machi ne was the use of bi nary numbers. (We discuss bi nary 
numbers in Sec. 0.2.) At around the same time, Howard Aiken of Harvard U ni versify 
was working on th eAutomatic Sequence-Controlled Calculator, known morecom- 
monly asMARKl, with support from IBM and the U.S. Navy. MARK I was very 
similar to the Analytical Engine in design and was described as "Babbage's dream 
come true." 

MARK I was an electromechanical computer based on relays. Mechanical 
relays were not fast enough, and MARK I was quickly replaced by machines based 
on electronic vacuum tubes. The first completely electronic computer, ENIAC I 
(Electronic Numerical Integrator And Calculator ), was built at the University of 
Pennsylvania under the supervision of John W. Mauchly and J. Presper Eckert. 
T hei r work was i nfl uenced by the work of J ohn A tanasoff. 

ENIAC I was programmed laboriously by plugging wires into a control 
panel that resembled an old telephone switchboard. Programming took an enor¬ 
mous amount of the engineers' time, and even making a simple change to a pro¬ 
gram was a time-consuming effort. While programming activities were going on, 
the expensive computer sat idle. To improve its productivity, John von Neumann 
of Princeton University proposed storing programs in the computer's memory. 
This stored program scheme not only improved computation speed but also al¬ 
lowed far more flexible ways of writing programs. For example, because a pro¬ 
gram is stored in the memory, the computer can change the program instructions 
to alter the sequence of the execution, thereby making it possible to get different 
results from a single program. 

We characterized these early computers with vacuum tubes as first-generation 
computers. Second-generation computers, with transistors replacing the vacuum 
tubes, started appearing in the late 1950s. Improvements in memory devices also 
increased processing speed further. In the early 1960s, transistors were replaced by 
integrated circuits, and third-generation computers emerged. A single integrated 
circuit of this period incorporated hundreds of transistors and made the construction 
of minicomputers possible. M inicomputers are small enough to be placed on desk¬ 
tops in individual offices and labs. The early computers, on the other hand, were so 
huge that they easily occupied the whole basement of a large building. 

Advancement of integrated circuits was phenomenal. Large-scale integrated 
circuits, commonly known as computer chips or silicon chips, packed the power 
equivalent to thousands of transistors and made the notion of a "computer on a sin¬ 
gle chip" a reality. With large-scale integrated circuits, microcomputers emerged in 
the mid-1970s. The machines we call personal computers today are descendants of 
the microcomputers of the 1970s. The computer chips used in today's personal 
computers pack the power equivalent to several millions of transistors. Personal 
computers are fourth-generation computers. 

Early microcomputers were isolated, stand-alone machines. The word per¬ 
sonal describes a machine as a personal device intended to be used by an individual. 
H owever, i t di d not take I ong to real i ze there was a need to share computer resources. 
For example, early microcomputers required a dedicated printer. Wouldn't it make 
more sense to have many computers share a single printer? Wouldn't it also make 
sense to share data among computers, instead of duplicating the same data on 
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network 

LAN 

WAN 

internet 


individual machines? Wouldn't it be nice to send electronic messages between the 
computers? The notion of networked computers arose to meet these needs. 

Computers of all kinds are connected into anetwork.A network that connects 
computers in a single building or in several nearby buildings is called a local-area 
network or LAN. A network that connects geographically dispersed computers is 
called a wide-area network or WAN. These individual networks can be connected 
further to form interconnected networks called internets. The most famous internet 
is simply called the Internet. The Internet makes the sharing of worldwide informa¬ 
tion possible and easy. The hottest tool for viewing information on the Internet is a 
l/l/eb browser. A Web browser allows you to experience multimedia information 
consisting of text, audio, video, and other types of information. We will describe 
how Java is related to the Internet and Web browsers in Section 0.4. 



If you want to learn more about the history of computing, there is a wealth of information 
available on the Web. You can start your exploration from 

Might www.yahoo.com/Computers_andJnternet/History 

Want . : ,,, For more information on the pioneers of computers, visit 

en.wikipedia.org/wiki/category:Computer_pioneers 


Quick 

CHECK 

V 


1 Who was the first computer programmer? 

2 Who designed the Difference Engine and Analytical Engine? 
3 . H ow many generations of computers are there? 


0.2 


Computer Architecture 


A typical computer today has five basic components: RA M , C PU, storage devices, 
I/O (input/output) devices, and communication devices. Figure 0.1 illustrates these 
five components. Before we describe the components of a computer, we will ex¬ 
plain the binary number system used in a computer. 


Binary Numbers 

To understand the binary number system, let's first review the decimal number sys¬ 
tem in which we use 10 digits: 0,1, 2, 3, 4, 5, 6, 7, 8, 9. To represent a number in 
the deci mal system, we use a sequence of one or more of these digits. T he val ue that 
each digit in the sequence represents depends on its position. For example, consider 
the numbers 234 and 324. The digit 2 in the first number represents 200, whereas 
the digit 2 in the second number represents 20. A position in a sequence has a 
value that is an integral power of 10. The following diagram illustrates how the 
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Devices 
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CPU, RAM, storage 
devices, and 
communication 
devices) 


Figure 0.1 A simplified view of an architecture for a typical computer. 


values of positions are determined: 

Decimal 

Point 


• • • • • • • 

10 4 10 3 10 2 10 1 10 ° 10 1 10 2 10 3 
Position Values 

T he val ue of a deci mal number (represented as a sequence of digits) is the sum 
of the digits, multiplied by their position values, as illustrated: 


2 4 8 -7 

io 2 io 1 io° io - 1 

= 2 x 10 2 + 4 x 10 1 + 8 x 10° + 7 x 10" 1 
= 2x100 + 4x10+8x1 + 7 x 1/10 

= 200 + 40 + 8 + 7/10 = 248.7 
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base-2 

numbers 

binary number 

bits 


In the decimal number system, we have 10 symbols, and the position values 
are integral powers of 10. We say that 10 is the base or radix of the decimal number 
system. The binary number system works the same as the decimal number system 
but uses 2 as its base. The binary number system has two digits (0 and 1) called bits, 
and position values are integral powers of 2. The following diagram illustrates how 
the values of positions are determined in the binary system: 


Binary 

Point 


24 2 3 2 2 2 1 2 ° 2 _1 2~ 2 2 ~^ 

Position Values 


The value of a binary number (represented as a sequence of bits) is the sum of 
the bits, multiplied by their position values, as illustrated: 


binary-to- 

decimal 

conversion 


I— 1 1 

0 

1—1 

• 

I—1 


22 2 1 2° 2 _1 

= 1 x 2 2 + 0 x 2 1 + 1 x 2° + 1 x 2' 1 
= 1x4 + 0x2 + lxl +1x1/2 
= 4 +0 +1 +1/2 =5.5 


decimal-to- 

binary 

conversion 


So the binary number 101.1 is numerically equivalent to the decimal num¬ 
ber 5.5. This illustration shows how to convert a given binary number to the 
decimal equivalent. How about converting a given decimal number to its binary 
equivalent? 

The following steps show how to convert a decimal number (only the whole 
numbers) to the equivalent binary number. The basic idea goes something like 
this: 

L Divide the number by 2. 

Z The remainder is the bit value of the 2° position. 

3. Divide the quotient by 2. 

4 The remainder is the bit value of the 2 1 position. 

5. Divide the quotient by 2. 

6. The remainder is the bit value of the 2 2 position. 

7. Repeat the procedure until you cannot divide any further, that is, until the 
quotient becomes 0. 
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The following diagram illustrates the conversion of decimal number 25. 


Division 

Division 

Division 

Division 

Division 

#5 

#4 

#3 

#2 

#1 

0 

1 

. 3 

. 6 

. 12 


2 rr— 

^ 2 }T — 


2j~25~ 

0 

2 

6 

12 

24 

l 

1 

0 

0 

1 

2 4 

2 3 

2 2 

2 1 

2° 

16 + 

8 

+ 0 

+ 0 + 

1 


The binary system is more suitable for computers than the decimal system be¬ 
cause it is far easier to design an electrical device that can distinguish two states 
(bits 0 and 1) than 10 states (digits 0 through 9). For example, we can represent 1 by 
turning the switch on and 0 by turning the switch off. In a real computer, 0 is repre¬ 
sented by electrical voltage below a certain level and 1 by electrical voltage at or 
above this level. 


O lou 


D Might 

When you pay closer attention to the on/off switch on computers and other 

Want to 

electronic devices,you should notice an icon like this 

Know 

6 


% 

This is a stylized representation of binary digits 0 and 1. 


RAM 

Random access memory or RAM is a repository for both program instructions and 
data manipulated by the program during execution. RAM is divided into cells, 
with each cell having a unique address. Typically, each cell consists of 4 ,te(B), 
and a single byte (1 B) in turn consists of 8 bits. Each bit, which can be either on 
or off, represents a single binary digit. RAM is measured by the number of bytes 
it contains. For example, 128 kilobytes (KB) of RAM contains 128 x 1024 = 
131,072 B because 1 KB is equal to 2 10 = 1024 B. Notice that 1 K is not equal to 
10 3 , although 10 3 = 1000 is a close approximation to 2 10 = 1024. The first IB M 
PC introduced in 1981 came with 16 KB of RAM, and the first Macintosh com¬ 
puter introduced in 1984 came with 128 KB of RAM. In contrast, a typical PC 
today has anywhere from 1GB (gigabytes) to 4GB of RAM. Given that 1GB is equal 
to 1024 M B (megabytes) and 1 M B is equal to 1024 K B, we know that 2G B means 
2 X 1024 M B = 2048 M B = 2048 X 1024 K B = 2,097,152 K B = 2,097,152 X 
1024 B = 2,147,483,648 B. 
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CPU 


register 


clock speed 


I/O devices 


nonvolatile and 

volatile 

memory 


CPU 

The central processing unit or CPU is the brai n of a computer. The C PU is the com¬ 
ponent that executes program instructions by fetching an instruction (stored in 
RAM ), executing it, fetching the next instruction, executing it, and so on until it en¬ 
counters an i nstruction to stop. T he C PU contai ns a smal I number of registers, which 
are high-speed devices for storing data or instructions temporarily. The CPU also 
contai ns thearithmetic-logic unit (A L U), which performs arithmetic operations such 
as addition and subtraction and logical operations such as comparing two numbers. 

CPUs are characterized by their clock speeds. For example, in the Intel 
Pentium 200, the CPU has a clock speed of 200 megahertz (MHz). The hertz is a 
unit of frequency equal to 1 cycle per second. A cycle is a period of time between 
two on states or off states. So 200 M Hz equals 200,000,000 cycles per second. The 
fastest CPU for commercially available personal computers was around 200 MHz 
in 1997 when the first edition of this textbook was published. But by the beginning 
of 1998, many vendors started selling 300-M Hz machines. And in a mere 6 months, 
by the middle of 1998, the top-of-the-line personal computers were 400-M Hz ma¬ 
chines. As of this writing in late 2008, we see computers with 2.93-GHz (2930- 
M Hz) CPU being advertized and sold. The increase of the CPU speed in the last two 
decades is truly astonishing. The clock speed of thelntel 8080, theCPU introduced 
in 1974 that started the PC revolution, was a mere 2 M Hz. In contrast, the clock 
speed of the Intel Pentium 4 introduced in 2001 was 2 GHz (2000 M Hz). Table 0.1 
lists some of the Intel processors. 

I/O Devices 

Input/output or I/O devices allow communication between the user and the CPU. 
Input devices such as keyboards and mice are used to enter data, programs, and 
commands in the CPU. Output devices such as monitors and printers are used to 
display or print information. Other I/O devices include scanners, bar code readers, 
magnetic strip readers, digital video cameras, and musical instrument digital inter¬ 
face (M IDI) devices. 

Storage Devices 

Storage devices such as disk and tape drives are used to store data and programs. Sec¬ 
ondary storage devices are called nonvolatile memory, while RA M is called ’olatile 
memory. Volatile means the data stored in a device will be lost when the power to the 
device is turned off. Being nonvolatileand much cheaper than RA M , secondary stor¬ 
age is an ideal medium for permanent storage of large volumes of data. A secondary 
storage device cannot replace RAM, though, because secondary storage is far slower 
in data access (getting data out and writing data in) compared to RAM . 

The most common storage device today for personal computers is a disk 
drive. There are two kinds of disks: hard and floppy (also known as diskettes). Hard 
disks provide much faster performance and larger capacity, but are normally not re¬ 
movable; that is, a single hard disk is permanently attached to a disk drive. Floppy 
disks, on the other hand, are removable, but their performance is far slower and 
their capacity far smaller than those of hard disks. As the standard floppy disks can 
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A table of Intel processors. For some CPUs, several types with different 
Table 0.1 clockspeeds are possible. In such case, only the fastest clockspeed is 
shown. For more information on Intel CPUs, visit http://www.intel.com. 



CPU 

Date 

Introduced 

ClockSpeed 

(MHz) 


4004 

11/15/71 

0.108 


8008 

4/1/72 

0.200 

1970s 

8080 

4/1/74 

2 


8088 

6/1/79 

8 


80286 

2/1/82 

12 

1980s 

80386SX 

6/16/88 

16 


80486DX 

4/10/89 

25 


Pentium 

3/22/93 

66 


Pentium Pro 

11/1/95 

200 

1990s 

Pentium II 

5/7/97 

300 


Pentium II Xeon 

6/29/98 

400 


Pentium III 

10/25/99 

733 


Xeon 

9/25/01 

2000 


Pentium 4 

4/27/01 

2000 

2000s 

Itanium 2 

7/8/02 

1000 


Pentium 4 Extreme 

Edition 

2/2/04 

3400 


Core 2 Extreme 

7/27/06 

3200 


store only up to approximately 1.44 M B, they are becoming less useful in today's 
world of multimegabyte image and sound files. They are fast becoming obsolete, 
and hardly anybody uses them anymore. Removable storage media with much 
higher capacity such as zip disks (capable of holding 100 to 250 M B of data) re¬ 
placed floppy disks in late 1990s. Computer technology moves so quickly that zip 
disks themselves are already becoming obsolete. The most common form of 
portable storage medium today (2008) is a compact USB flash drive, also known as 
a thumb drive, whose capacity ranges from 125 M B to 16 G B. 

Hard disks can store a huge amount of data, typically ranging from 160 GB 
(gigabyte; 1 GB = 1024 M B) to 500 GB for a standard desktop PC in 2008. Portable 
and removable hard disk drives, with performance and capacity that rival those of 
nonremovable hard disks, are also available, but their use is not widespread. 

Compactdisks(CDs) arecommonly used for storing massiveamountsof data, 
approximately 700 M B. M any software packages we buy today—computer games, 
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word processors, and others— come with asingleCD. Before the CD became a popu¬ 
lar storage device for computers, some software packages came with more than 
20 floppy diskettes. Becauseof the massive storage capacity of theCD,mostcomputer 
vendors el i mi nated pri nted manual s altogether by putti ng the manuals on the C D. 



Many companies, in addition to CD or in lieu of, provide "boxless" online distribu¬ 
tion of software. With this scheme, we buy and download the software directly to 
our computers from the company websites. From some book publishers, especially 
in the professional market, we can even buy an online version of their books. The 
online version is most commonly downloaded as a single file stored in the Portable 
Document Format (PDF) format. 


Communication Devices 

communication A communication device connects the personal computer to an internet. The tradi- 
device tional communication device for computers at home and in small offices was the 

modem. A modem, which stands for modulator-demodulator, is a device that con¬ 
verts analog signals to digital and digital signals to analog. By using a modem, a 
computer can send to and receive data from another computer over the phone line. 
The most critical characteristic of a modem is its transmission speed, which is mea¬ 
sured in bits per second (bps). A typical speed fora modem is 56,000 bps, commonly 
called a 56K modem. U nder an ideal condition (no line noise or congestion), a 56K 
modem can transfer a 1 MB file in about T-A minutes. Frequently, though, the actual 
transfer rate is much lower than the possible maximum. So-called DSL and cable 
modems are not truly modems because they transfer data strictly in digital mode, 
which allows for much faster connection speeds of 144K or above. H igh-speed satel¬ 
lite connection to the Internet is also avail able today. 

A communication device for connecting a computer to a LAN is a network 
interface card (NIC). A NIC can transfer data at a much faster rate than the fastest 
modem. For instance, a type of N 1C called lOBaseT can transfer data at the rate of 
10 M bps over the network. Traditional networks areconnected, or wired, by thecables. 
Increasingly, networks are connected wirelessly, where data are carried over radio 
waves. Wireless networking is called WiFi or 802.11 networking. Today you will find 
wireless networking almost universally available at airports, hotels, and universities. 

L Name five major components of a computer. 

2 What is the difference between volatile and nonvolatile memory? 

3. What does the acronym CPU stand for? 

4 How many bytes does the 64 K B RAM have? 

5l Which device connects a computer to the Internet using a phone line? 


Quick 

CHECK 


www.it-ebooks.info 





machine 

language 


machine code 


assembly 

language 


assembly code 


assembler 


high-level 

languages 


high-level code 


0.3 Programming Languages 11 


0.3 Programming Languages 

Programming languages are broadly classified into three levels: machine languages, 
assembly languages, and high-level languages. Machine language is the only pro¬ 
gramming language the CPU understands. Each type of CPU has its own machine 
language. For example, the Intel Pentium and M otorola PowerPC understand differ¬ 
ent machine languages. Machine-language instructions are binary-coded and very 
low level—one machine instruction may transfer the contents of one memory loca¬ 
tion into a C PU register or add numbers in two registers. Thus, we must provide many 
machine-language instructions to accomplish a simple task such as finding the aver¬ 
age of 20 numbers. A program written in machine language might look like this: 

10110011 00011001 
01111010 11010001 10010100 
10011111 00011001 
01011100 11010001 10010000 
10111011 11010001 10010110 

One level above machine language is assembly language, which allows 
"higher-level" symbolic programming. Instead of writing programs as a sequence 
of bits, assembly language allows programmers to write programs by using sym¬ 
bolic operation codes. For example, instead of 10110011, we use mv to move the 
contents of a memory cell into a register. We also can use symbolic, or mnemonic, 
names for registers and memory cells. A program written in assembly language 
mightlook likethis: 

MV 0, SUM 

MV NUM, AC 

ADD SUM, AC 

STO SUM, TOT 

Since programs written in assembly language are not recognized by the CPU, 
we use an assembler to translate programs written in assembly language into 
machine-language equivalents. Compared to writing programs in machine lan¬ 
guage, writing programs in assembly language is much faster, but not fast enough 
for writing complex programs. 

High-level languages were developed to enable programmers to write pro¬ 
grams faster than when using assembly languages. For example, FORTRAN 
(FORmulaTRA Nslator), a programming language intended for mathematical com¬ 
putation, allows programmers to express numerical equations directly as 

X = (Y + Z) / 2 

COBOL (COmmon Business-Oriented Language) is a programming language in¬ 
tended for business data processing applications. FORTRA N and COBOL were de¬ 
veloped in the late 1950s and early 1960s and are still in use. BASIC (Beginners 
All-purpose Symbolic Instructional Code) was developed specifically as an easy 
language for students to learn and use. BASIC was the first high-level language 
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available for microcomputers. Another famous high-level language is Pascal, which 
was designed as an academic language. Since programs written in a high-level lan- 
compiier guage are not recognized by the CPU, we must use a compiler to translate them to 

assembly language equivalents. 

The programming languageC was developed intheearly 1970s atAT&T Bell 
Labs. The C++ programming language was developed as a successor of C in the 
early 1980s to add support for object-oriented programming. Object-oriented pro¬ 
gramming is a style of programming gaining wider acceptance today. Although the 
concept of object-oriented programming is old (the first object-oriented program¬ 
ming language, Simula, was developed in the late 1960s), its significance wasn't 
realized until the early 1980s. Smalltalk, developed at Xerox PARC, is another 
well-known object-oriented programming language. The programming language 
we use in this book is Java, the newest object-oriented programming language, 
developed at Sun M icrosystems. 


Java 


applet 


application 


0.4 


Java 


Java is a new object-oriented language that is receiving wide attention from both indus¬ 
try and academia. Java was developed by James Gosling and his team at Sun M icrosys¬ 
tems in California. The language was based on C and C ++ and was originally intended 
for writing programs that control consumer appliances such as toasters, microwave 
ovens, and others. The language was first called Oak, named after the oak tree outside 
of Gosling's office, but the name was already taken, so the team renamed it Java. 

J ava is often described as a Web programming language because of its use in 
writing programs called applets that run within a Web browser. That is, you need a 
Web browser to executejava applets. Applets allow more dynamic and flexible dis¬ 
semination of information on the Internet, and this feature alone makes Java an at¬ 
tractive language to learn. However, wearenotlimited to writing applets in Java. We 
can write Java applications also. A Java application is a complete stand-alone 
program that does not require a Web browser. A Java application is analogous to a 
program we write in other programming languages. In this book, we describejava 
applications only because our objecti ve is to teach the fundamentals of object-oriented 
programming that are applicable to all object-oriented programming languages. 

We chosej ava for this textbook mainly for its clean design. The language de¬ 
signers of Java took a minimalist approach; they included only features that are in¬ 
dispensable and eliminated features that they considered excessive or redundant. 
This minimalist approach makes Java a much easier language to learn than other 
object-oriented programming languages. Java is an ideal vehicle for teaching the 
fundamentals of object-oriented programming. All the sample programs in this 
book are tested against the newest version, J ava 6.0. 


Summary 


Charles Babbage invented the Difference Engine and Analytical Engine, 
precursors to the modern computer. 

Ada Lovelace is considered the first computer programmer. 
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• Thefirsttwo modem computers were M A RK I and ENIAC I. 

• John von Neumann invented thestored-program approach of executing 
programs. 

• Computers are connected into a network. Interconnected networks are 
called internets. 

• B i nary numbers are used i n computers. 

• A typical computer consists of five components: RA M,CPU, storage 
devices, I/O devices, and communication devices. 

• There are three levels of programming languages: machine, assembly, and 
high-level. 

• Java is one of the newest high-level programming languages in use today. 
This textbook teaches how to program using Java. 


Key Concepts 


network 

LAN 

WAN 

internets and Internet 

CPU 

RAM 

I/O devices 

communication devices 


binary numbers 
binary-to-decimal conversion 
machine language 
assembly language 
assembler 
high-level language 
compiler 
Java 


Exercises 


Review Exercises 


L Visit your school's computer lab or a computer store, and identify the 
different components of the computers you see. Do you notice any unique 
input or output devices? 

2 Visit your school's computer lab and find out the CPU speed, RAM size, and 
hard disk capacity of its computers. 

3. Convert these binary numbers to decimal numbers. 

a 1010 

b. 110011 

c. 110.01 

d. mm 
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4, Convert these decimal numbers to binary numbers. 

a 35 
b. 125 
c 567 

d. 98 

5b What is the maximum decimal number you can represent in 4 bits? 16 bits? 
N bits? 

& If a computer has 128 MB of RA M , how many bytes are there? 

7. How do high-level programming languages differ from low-level 
programming languages? 

a Consider a hypothetical programming language called Kona. Using Kona, 
you can write a program to compute and print out the sum of 20 integers 
entered by the user: 

let s um = 0; 

repeat 20 t i me s [ 
let X = next input; 
add X to sum; 


printout sum; 

Is Kona a high-level language? Why or why not? 
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After you have read and studied this chapter, you 
should be able to 

• Name the basic components of object- 
oriented programming. 

• Differentiate classes and objects. 

• Differentiate class and instance methods. 

• Differentiate class and instance data values. 

• Draw program diagrams using icons for 
classes, objects, and other components of 
object-oriented programming. 

• Describe the significance of inheritance in 
object-oriented programs. 

• Name and explain the stages of the software 
life cycle. 




16 Chapter 1 Introduction to Object-Oriented Programming and Software Development 


Introduct 



object- 

oriented 

programming 


efore we begin to write actual programs, we need to introduce a few basic 
concepts of object-oriented programming (OOP), the style of programmi ng we teach 
in this book. The purpose of this chapter is to give you a feel for object-oriented 
programmi ng and to i ntroduce a conceptual foundati on of obj ect-ori ented programmi ng. 
You may want to refer to this chapter as you progress through the book. What 
we discuss in the next four sections is independent of any particular programming 
language. 

Another purpose of this chapter is to introduce the software development 
process. To be able to write programs, knowledge of the components of object- 
oriented programs is not enough. We must learn the process of developing pro¬ 
grams. We will present a brief introduction to the software development process in 
this chapter. 


1.1 Classes and Objects 

The two most important concepts in object-oriented programming are the class 
object and the object. In the broadest term, an object is a thing, both tangible and intangi¬ 

ble, that we can imagine. A program written in object-oriented style will consist 
of interacting objects. For a program to keep track of student residents of a college 
dormitory, we may have many student, Room, and Floor objects. For another pro¬ 
gram to keep track of customers and inventory for a bicycle shop, we may have 
Customer, Bicycle, and many other types of objects. An object is comprised of data 
and operations that manipulate these data. For example, a student object may con¬ 
sist of data such as name, gender, birth date, home address, phone number, and age 
and operations for assigning and changing these data values. We will use the nota¬ 
tion shown in Figure 1.1 throughout the book to represent an object. The notation 
we used in the book is based on the industry standard notation called UML, which 
stands for Unified Modeling Language. In some of the illustrations, we relax the 
rules of U M L slightly for pedagogy. 

Almost all nontrivial programs will have many objects of the same type. 
For example, in the bicycle shop program we expect to see many Bicycle and other 


cObiect name> 


Example: 


accountl 


We use a rectangle to 
represent an object and 
place the underlined 
name of the object 
inside the rectangle. 


H This is an object 
named accountl. 


Figure l.lA graphical representation of an object. 
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Moto-1: Bicycle 


Moto-2 : Bicycle 


I on I ava : Customer 


H An object name is followed 
by the class name. 


Figure 1.2 Two Bicycle objects with the names Moto-1 and Moto-2 and one Customer object with the name 
Jon Java. 


objects. Figure 1.2 shows two Bicycle objects with the names Moto-i and Moto -2 
and one Customer object with the name Jon Java. 

Inside a program we write instructions to create objects. For the computer to 
class be able to create an object, we must provide a definition, called a class. A class is a 

kind of mold or template that dictates what objects can and cannot do. An object 
instance is called an instance of a class. An object is an instance of exactly one class. An 

instance of a class belongs to the class. The two Bicycle objects Moto-i and Moto -2 
are instances of the Bicycle class. Once a class is defined, we can create as many 
instances of the cl ass as a program requires. 


Liftings to Remember 

A class must be defined before you can create an instance (object) of the class. 



Figure 1.3 shows a diagram that we will use throughout the book to represent 
a class. 


/ \ 

Notice the name of a 

class is not underlined 
while the name of an 
object is. 

v____ J 


<C 1 ass Name> 






We use a rectangle to 
represent a class with 
its name appearing 
inside the rectangle. 


Example: 

Account 


Figure 1.3 A graphical representation of a class. 
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w 

Quick 

CHECK 


1. Draw an object diagram for a Person class and two Person objects, Ms. Latte 
and Mr. Espresso. 

2. W hat must be defined before you can create an object? 



I Oil 

Might 
Want to 
Know 


Many beginning programmers may not see the distinction between the class and object as 
clearly as the more experienced programmers do.lt may be helpful to compare the class and 
object to a woodcut and the prints produced from the woodcut. A woodcut is a block of 
wood engraved with a design for printing. Once you have a woodcut,you can make as many 
prints as you wish. Similarly, once you have a class, you can make as many objects from the 
class. Also, just as you cannot make prints without having a woodcut, you cannot create an 
object without first defining a class. For sample prints by the 19th-century Japanese artist 
Hiroshige, visit 

http://www.ibiblio.org/wm/paint/auth/hiroshige/ 


message 


method 


class and 
instance 
methods 


argument 


1.2 


Messages and Methods 


In writing object-oriented programs we must first define classes, and while the pro¬ 
gram is running, we use the classes and objects from these classes to accomplish 
tasks. A task can range from adding two numbers, to computing an interest payment 
for a college loan, to calculating the reentry angle of a space shuttle. To instruct a 
class or an object to perform atask, wesend amessage to it. For example, wesend 
a message deposit to an Account object to deposit $100. 

For a class or an object to process the message, it must be programmed ac¬ 
cordingly. You cannot just send a message to any class or object. You can send a 
message only to the classes and objects that understand the message you send. For 
a class or an object to process the message it receives, it must possess a matching 
method, which is a sequence of instructions that a class or an object follows to 
perform a task. A method defined for a class is called a class method, and a method 
defined for an object is an instance method. 

Let's look at an example of an instance method first. Suppose a method called 
walk is defined for a Robot object and instructs the robot to walk a designated dis¬ 
tance. With this method defined, we can send the message walk to a Robot object, 
along with the distance to be walked. A value we pass to an object is called an 
argument of a message. N otice that the name of the message we send to an object or 
a class must be the same as the method's name. I n F igure 1.4 we represent the send¬ 
ing of a message. 
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The diagram in Figure 1.4 illustrates one-way communication; that is, an 
object carries out the requested operation (it walks the designated distance) but 
does not respond to the message sender. In many situations, we need a reply in 
which an object responds by returning a value to the message sender. For exam¬ 
ple, suppose we want to know the distance from a robot to its nearest obstacle. 
The designer of a robot may include a method getobstacleDistance that returns 
the desired value. The diagram in Figure 1.5 shows a method that returns a value 
to the message sender. Instead of returning a numerical value, a method can re¬ 
port back the status of the requested operation. For example, a method walk can 
be defined to return the status success/fail to indicate whether the specified 
distance was covered successfully or not (e.g., it fails when the robot bumps into 
an obstacle). 

Now let's look at an example of class methods. The class method getMaxi- 
mumSpeed shown in Figure 1.6 returns the maximum possible speed of all Robot 
objects. A method such as getMaximumSpeed that deals with collective information 
about the instances of a class is usually defined as a class method. So we define an 
instance method for a task that pertains to an individual instance and a class method 
for a task that pertains to all instances. 


Message walk with I_ 

the argument 25. | 

wal k(25) 


fido : Robot 


Figure 1.4 Sending the message walk to a Robot object. 


This shows that we are not 
sending any argument. 


getO bstacleD istance( 
distance 


fido : Robot 


This shows the value 
distance is returned as 
a response to the message. 


Figure 1.5 The result distance is returned to the sender of the message. 
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getM aximumSpeed() 
maximum speed 


Figure 1.6 The maximum possible speed of all Robot objects is returned by the class method 

getMaximumSpeed. 


Robot 


F— 

Quick 

CHECK 


1. Draw an object diagram of an Account object with instance methods deposit 
and withdraw. 

2. IsthegetObstacleDistance method an instance or a class method? 


1.3 Class and Instance Data Values 

Suppose the method deposit of an Account object instructs the object to add a given 
amount to the current balance. Where does the object keep the current balance? 
Remember that an object is comprised of data values and methods. Analogous to 
defining class and instance methods, we can define class and instance data values. 

instance data For example, we define an instance data value current balance for Account objects 

value to record the current balance. Figure 1.7 shows three Account objects with their 

data values current balance. Notice that they all have the same data value current 
balance. A11 i nstances of the same cl ass w i 11 possess the same set of data val ues. T he 
actual dollar amounts for current balance, as the di agram i 11 ustrates, differ from one 
instance to another. Items such as opening balance and account number are other 
possible instance data values for Account objects. 

class data value A class data value is used to represent information shared by all instances or to 

represent collective information about the instances. For example, if every account 
must maintain a minimum balance of, say, $100, we can define a class data value 
minimum balance. An instance can access the class data values of the class to which 
it belongs, so every Account object can access the class data value minimum balance. 


Iohn’s: Account 

current balance 


908.55 


I ills : Acco unt 


current balance 


lack’s: Account 

current balance 


1304.98 




354.00 


Figure 1.7 Three Account objects possess the same data value current balance, but the actual dollar 
amounts differ. 
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Notice the class data value is 
underlined to show the fact that this 
value is accessible to individual 
objects, which are underlined. 



Iohn’s: Account 

current balance 


Mil’s: Account 


current balance 


lack’s: Account 

current balance 


908.55 




1304.98 




354.00 


Figure 1.8 Three Account objects sharing information (minimum balance = $100) stored as a class data value. 


Figure 1.8 shows how we represent a class data value. Notice that we underline the 
cl ass data val ue. B ecause the obj ects of a cl ass are underl i ned, and the cl ass data val - 
ues are accessible to all objects of the class, we likewise underline the class data 
data member value to show this relationship. Data values are also called data members because 
they belong to a class or instance of the class. 

To appreciate the significance of a class data value, let's see what happens if 
we represent minimum balance as an instance data value. Figure 1.9 shows three 
Account objects having different dollar amounts for the current balance but the 
same dollar amount for the minimum balance. Obviously, this duplication of mini¬ 
mum balance is redundant and wastes space. Consider, for example, what happens 
if the bank raises the minimum balance to $200. If there are 100 Account objects, 
then all 100 copies of minimum balance must be updated. We can avoid this by 
defining minimum balance as a class data value. Figure 1.10 shows another exam¬ 
ple where the opening and closing times are shared by all cafeterias on campus. 

There are two types of data values: those that can changeover time and those 
variable that cannot. A data value that can change is called a variable, and one that cannot 


I ohn’s: Account 

current balance 
908.55 

minimum balance 
100.00 


Mil’s: Account 


lack’s: Account 

current balance 

current balance 


1304.98 



354.00 


minimum balance 

minimum balance 


100.00 



100.00 



Figure 1.9 Three Account objects duplicating information (minimum balance = $100) in instance data values. 
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U nion: Cafeteria 



West: Cafeteria 


revenue 


revenue 


QuikBite: Cafeteria 


revenue 


1917.34 




2306.99 




430.75 


Figure 1.10 Three Cafeteria objects sharing the same opening and closing times, stored as class data values. 


A ccount 

minimum balance 

100.00 


We assume this number is 
a prefix to the account 
number of all accounts, and 
the prefix never changes. 


account prefix 

{frozen}- 

— 6427 


This keyword indicates 
the value is locked and 
cannot be changed. 


lohn’s: Account 

current balance 


opening balance 
{frozen} 


I ill’s: Account 

current balance 


opening balance 
{frozen} 


lack’s: Account 

current balance 


908.55 




1304.98 




354.00 


opening balance 
{frozen} 


246.00 




50.00 




100.00 


Figure 1.11 Graphical representations for four types of data values: class variable, class constant, instance 
variable,and instance constant. 


constant change is a constant Figure 1.11 illustrates how we represent and distinguish be¬ 

tween variables and constants. We use the keyword frozen for constants to indicate 
that they cannot change. Notice that we now have four kinds of data values: class 
variables, class constants, instance variables, and instance constants. 
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w 

Quick 

CHECK 

V 


inheritance 


superclass and 
subclass 


Figure 1.12 


1. W hat is the difference between a constant and a variable? 

2. Draw an object diagram of a Person object with the three instance variables 
name, age, and gender. 


1.4 Inheritance 

When we used the Account class and its instances to illustrate object-oriented con¬ 
cepts, some of you were probably thinking about checking accounts, while others 
may have been thinking about savings accounts. We did not distinguish between the 
two in the examples. But when we look at the problem a little more carefully, we 
will realize that in fact these two types of accounts are different, even though they 
share many features. 

In general, using only a single class to model two or more entities that are 
similar but different is not good design. In object-oriented programming, we use a 
mechanism called inheritance to design two or more entities that are different but 
share many common features. First we define a class that contains the common fea¬ 
tures of the entities. Then we define classes as an extension of the common class 
inheriting everything from the common class. We call the common class the 
superclass and all classes that inherit from it subclasses. We also call the superclass 
an ancestor and the subclass a descendant. Other names for superclass and subclass 
are base class and derived class, respectively. For the bank example, we can define 
a superclass Account and then define Savings and Checking as subclasses of 
Account. We represent the superclass and its subclasses as shown in Figure 1.12. 
Notice that we draw arrows from each subclass to its superclass because a subclass 
can refer to items defined in its superclass, but not vice versa. 

Inheritance is not limited to one level. A subclass can be a superclass of other 
classes, forming an inheritance hierarchy. Consider the exampleshown in Figure 1.13. 


A ccount 



_Z 

Savings 


\ 

Checking 


A superclass Account and its subclasses Savings and Checking. 
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Figure 1.13 An example of inheritance hierarchy among different types of students. 


Inheritance is very powerful, and if it is used properly, we can develop complex 
programs very efficiently and elegantly. The flip side of using a very powerful tool 
is that if we do not use it correctly, we could end up in a far worse situation than if 
we did not use it. We will be seeing many examples of inheritance throughout this 
book. In Chapter 2, for example, we will introduce many classes that come with the 
J ava system. M ost of these classes are defined using inheritance. We will provide an 
in-depth discussion of inheritance and related topics in Chapter 13. 


Quick 

CHECK 

V 


1. If Class A inherits from Class B, which is a superclass? Which is a subclass? 

2. Draw a diagram that shows Class A is inheriting from Class B. 

3. W hat are the other names for superclass and subclass? 

4. If we have Animal, Insect, and Mammal classes, which one will be a 
superclass? 

5. Model different types of vehicles, using inheritance. Include Vehicle, 
Automobile, Motorcycle, Sports Car, Sedan, and Bicycle. 


1.5 Software Engineering and Software Life Cycle 

When we say computer programming, we are referring not only to writing Java 
commands, but also to a whole process of software development. Knowing a pro¬ 
gramming language alone is not enough to become a proficient software developer. 
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software life 
cycle 

software 

engineering 


analysis 


design 


coding 


testing 


debugging 

operation 

software 

maintenance 


You must know how to design a program. This book will teach you how to design 
programs in an object-oriented manner. 

We construct a house in well-defined stages and apply the engineering princi¬ 
ples in all stages. Similarly, we build a program in stages and apply disciplined 
methodology in all stages of program development. The sequence of stages from 
conception to operation of a program is called the software life cycle, and software 
engineering is the application of a systematic and disciplined approach to the 
development, testing, and maintenance of a program. 

There are five major phases in the software life cycle: analysis, design, coding, 
testing, and operation. Software starts its life from the needs of a customer. A person 
wants an online address book, for example. I n the analysis phase, we perform a fea¬ 
sibility study. We analyze the problem and determine whether a solution is possible. 
Provided that a solution is possible, the result of this phase is a requirements speci¬ 
fication that describes the features of a program. The features must be stated in a 
manner that is testable. One of the features for the address book program may be the 
capability to search for a person by giving his or her first name. We can test this 
feature by running the program and actually searching for a person. We verify that 
the program behaves as specified when the first name of a person in the address 
book and the first name of a person not in the address book are entered as a search 
condition. We do this testing in the testing phase, which we will explain shortly. 

In the design phase, we turn a requirements specification into a detailed design 
of the program. For an object-oriented design, the output from this phase will be a 
set of classes that fulfill the requirements. For the address book program, we may 
design classes such as Person, Phone, and others. 

In the coding phase, we implement the design into an actual program, in our 
case, ajava program. Once we have a well-constructed design, implementing itinto 
actual code is really not that difficult. The difficult part is the creation of the design, 
and in this book, we place greater emphasis on the design aspect of the software 
construction. 

When the implementation is completed, we move to the testing phase. In this 
phase, we run the program, using different sets of data to verify that the program 
runs according to the specification. Two types of testing are possible for object- 
oriented programs: unit testing and integration testing. With unit testing, we test 
classes individually. With integration testing, we test that the classes work together 
correctly. Activity to eliminate programming error is called debugging. An error 
could be a result of faulty implementation or design. When there's an error, we need 
to backtrack to earlier phases to eliminate the error. 

Finally, after the testing is successfully concluded, we enter the operation 
phase, in which the program will be put into actual use. The most important and 
time-consuming activity during the operation phase is software maintenance. After 
the software is put into use, we almost always have to make changes to it. For 
example, the customer may request additional features, or previously undetected 
errors may be found. Software maintenance means making changes to software. It 
is estimated that close to 70 percent of the cost of software is related to software main¬ 
tenance. So naturally, when we develop software, we should aim for software that 
is easy to maintain. We must not develop a piece of software hastily to reduce the 
software development cost. We should take time and care to design and code 
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software correctly even if it takes longer and costs more to develop initially. In 
the long run, carefully crafted software will have a lower total cost because of the 
reduced maintenance cost. Here's an important point to remember: 


Ljjlings to Remember 

Well-designed and -constructed software is easy to maintain. 



In this book, we will focus on the design, coding, and testing phases. We will pre¬ 
sent a requirements specification in the form of a problem statement for the sample 
programs we will develop in this book. We present the first sample program devel¬ 
oped by following the design, coding, and testing phases in Chapter 2. We will 
come back to the discussion of software engineering and the software life cycle 
throughout the book and provide more details. 


W 

Quick 

CHECK 

V 


1. Name the stages of the software life cycle. 

2. How does the quality of design affect the software maintenance cost? 

3. What is debugging? 


Summary 


• The style of programming we teach in this book is called object-oriented 
programming. 

• An object is an instance of a class. M any instances can be created from a 
single cl ass. 

• There are class and instance methods. We can send messages to objects and 
classes if they possess matching methods. 

• T here are cl ass and i nstance data val ues. D ata val ues are al so cal I ed data 
members. 

• Inheritance is a powerful mechanism to model two or more entities that are 
different but share common features. 

• The sequence of software development stages from conception to operation 
is called the software life cycle. 

• Five major phases of the software life cycle are analysis, design, coding, 
testing, and operation. 
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Software engineering is the application of a systematic and disciplined 
approach to the development, testing, and maintenance of a program. 


Key Concepts 


object-oriented programming 

class 

object 

message 

class and instance methods 

instance and class data values 

variable 

constant 

inheritance 


superclass (ancestor, base class) 

subclass (descendant, derived class) 

software life cycle 

software engineering 

analysis 

design 

coding 

testing 

operation 


Review Excercises 

1. Graphically represent a Vehicle class and three Vehicle objects named carl, 
car2, and car3. 

2. Graphically represent a Person class with the following components: 

• I nstance variables name, age, and gender. 

• I nstance methods setName, getName, and getAge. 

• Class method getAverageAge. 

3. Design a CD class where a CD object represents a single music CD. What 
kinds of information (artist, genre, total playing time, etc.) do you want to 
know about a CD? Among the information in which you are interested, 
which are instance variables? Are there any class variables or class constants? 

4. Suppose the Vehicle class in Exercise 1 is used in a program that keeps track 
of vehicle registration for the Department of M otor Vehicles. What kinds of 
instance variables would you define for such Vehicle objects? Can you think 
of any useful class variables for the Vehicle class? 

5. Suppose the following formulas are used to compute the annual vehicle 
registration fee for the vehicle registration program of Exercise 4: 

• For cars, the annual fee is 2 percent of the value of the car. 

• For trucks, the annual fee is 5 percent of the loading capacity (in pounds) 
of the truck. 

Define two new classes Car and Truck as subclasses of Vehicle. Hint: Associate 
class and instance variables common to both Car and Truck to Vehicle. 
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6. Consider a student registration program used by the registrar's office. The 
program keeps track of students who are registered for a given semester. For 
each student registered, the program maintains the student's name, address, 
and phone number; the number of classes in which the student is enrolled; 
and the student's total credit hours. The program also keeps track of the total 
number of registered students. Define instance and class variables of a 
student class that is suitable for this program. 

7. Suppose the minimum number and maximum number of courses for which a 
student can register are different depending on whether the student is a 
graduate, undergraduate, or work/study student. Redo Exercise 6 by defining 
classes for different types of students. Relate the classes, using inheritance. 

8. Imagine you are given the task of designing an airline reservation system that 
keeps track of flights for a commuter airline. List the cl asses you think would be 
necessary for designing such asystem. Describe the data values and methods 
you would associate with each cl ass you identify. Note: For this exercise and 

E xerci ses 9 through 12, we are not expecti ng you to desi gn the system i n 
compl ete detai I. T he obj ecti ve of these exerci ses i s to gi ve you a taste of 
thinking about a program at a very high level. Try to identify about a half dozen 
or so classes, and for each class, describe several methods and data members. 

9. Repeat Exercise 8, designing a university course scheduling system. The 
system keeps track of classes offered in a given quarter, the number of 
sections offered, and the number of students enrolled in each section. 

10. Repeat Exercise 8, designing the state Department of M otor Vehicles 
registration system. The system keeps track of all licensed vehicles and 
drivers. Flow would you design objects representing different types of 
vehicles (e.g., motorcycles and trucks) and drivers (e.g., class A for 
commercial licenses and class B for towing vehicles)? 

11. Repeat Exercise 8, designing a sales tracking system for a fast-food 
restaurant. The system keeps track of all menu items offered by the 
restaurant and the number of daily sales per menu item. 

12. W hen you write a term paper, you have to consult many references: books, 
journal articles, newspaper articles, and so forth. Repeat Exercise 8, 
designing a bibliography organizer that keeps track of all references you 
used in writing a term paper. 

13. Consider the inheritance hierarchy given in Figure 1.12. List the features 
common to all classes and the features unique to individual classes. Propose 
a new inheritance hierarchy based on the types of accounts your bank offers. 

14. Consider a program that maintains an address book. Design an inheritance 
hierarchy for the classes such as Person, ProfessionalContact, Friend, and 
student that can be used in implementing such a program. 

15. Do you think the design phase is more important than the coding phase? 

Why or why not? 

16. Flow does the quality of design affectthe total cost of developing and 
maintaining software? 
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Getting Started with Java 


I 


Objectives 


After you have read and studied this chapter,you 
should be able to 

• Identify the basic components of Java 
programs. 

• Write simple Java programs. 

• Describe the difference between object 
declaration and object creation. 

• Describe the process of creating and running 
Java programs. 

• Use the Date, SimpleDateFormat, String, and 
Scanner classes from the standard Java 
packages. 

• Develop Java programs, using the incremental 
development approach. 
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Introduction 



W 

e will describe the basic structure of simple Java programs in this chapter. We 
will also describe the steps you follow to run Java programs. We expect you to 
actually run these sample programs to verify that your computer (either your own or 
the one at the school’s computer center) is set up properly to run the sample 
programs presented in the book. It is important to verify this now. Otherwise, if you 
encounter a problem later, you won’t be able to determine whether the problem is 
the result of a bad program or a bad setup. Please check Appendix A for information 
on how to run the textbook’s sample programs. 

We will develop a sample application program in Section 2.4 following the 
design, coding, and testing phases of the software life cycle. We stress here again 
that our objective in this book is to teach object-oriented programming and how to 
apply object-oriented thinking in program development. The Java language is 
merely a means to implement a design into an executable program. We chose Java 
for this book because Java is a much easier language than other object-oriented pro¬ 
gramming languages to use to translate a design into an actual code. Beginning stu¬ 
dents often get lost in the language details and forget the main objective of learning 
the development process, but the use of Java should minimize this problem. 



Those of you who have some experience in programming, whether object- 
oriented or non-object-oriented, will probably find many similarities between 

I Java and the programming languages you already know.This similarity may ac¬ 
celerate your learning process, but in many cases what seems to be similar at first 
may turn out to be quite different. So please do not jump to any conclusions 
about similarity prematurely. 


pixel 


2.1 


The First Java Program 


Our first Java application program displays a window on the screen, as shown in - 
Figure 2.1. The size of the window is set to 300 pixels wide and 200 pixels high. A pixel 
is a shorthand for picture element, and it is the standard unit of measurement for the 
screen resolution. A common resolution for a 19-in screen, for example, is 1280 pixels 
wide and 1024 pixels high. The title of the window is set to My First Java Program. 
Although this program is very simple, it still illustrates the fundamental structure of an 
object-oriented program, which is as follows: 


LjU^ings to Remember 

An object-oriented program uses objects. 
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Figure 2.1 Result of running the Ch2Sample1 program.The window size is 300 by 200 pixels and has the 
title My First Java Program. 

It may sound too obvious, but let’s begin our study of object-oriented programming 
with this obvious notion. Here’s the program code: 


/* 

Chapter 2 Sample Program: Displaying a Window 
File: Ch2Sampl el.j ava 

*/ 

import j avax. swi ng. *; 
class C h 2 S a mp I e 1 { 


public 

st at 

i c 

void 

ma 

i n 

(St 

r i n g [ ] 

ar gs 

{ 

J F 

r a me 


myWi n 

do 

w; 





my 

Wi ndo 

w 

= new 

J F 

r a 

me ( 

): 



my 

Wi ndo 

w. 

set Si z 

e( 

30 

0 , 

2 0 0 ); 



my 

Wi ndo 

w. 

s e t T i t 

1 e 

(" 

My 

First 

java Program 

my 

Wi ndo 

w. 

set Vi s 

i b 

1 e 

(tr 

u e ) ; 




} 

} 



Closing the frame window of the Ch2Sample1 program does not terminate the 
program itself. Most common Java development tools provide a simple way, such 
as clicking a toolbar button, to terminate a running program. If you are using a 
Java development tool that does not let you stop a running program easily, then 
insert the statement 

myWi ndow. set Def aul tCI oseOperati on(j Fra me. EXI T_0N_CL0SE) ; 
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after 


myWi ndow. setVi si bl e(true) ; 


so the program terminates automatically when the frame window is closed. Please 


read Appendix A for more information. 


programmer- 
defined classes 


standard 

classes 


program 

diagram 


dependency 

relationship 


This program declares one class called Ch2Sample1, and the class includes 
one method called main. From this main method, the Ch2Sample1 class creates and 
uses a JFrame object named myWindow by sending the three messages setSize, 
setTitle, and setVisible to the object. The JFrame class is one of many classes that 
come with the Java system. An instance of this JFrame class is used to represent a 
single window on the computer screen. To differentiate the classes that program¬ 
mers define, including ourselves, and the predefined classes that come with the Java 
system, we will call the first programmer-defined classes and the latter Java stan¬ 
dard classes, or simply, standard classes. We also use the term system classes to 
refer to the standard classes. 

Expressing this program visually results in the program diagram shown in 
Figure 2.2. In this diagram, we draw individual messages, but doing so would eas¬ 
ily clutter a diagram when we have more than a handful of messages. Instead of 
drawing messages individually, we can draw one arrow to represent a dependency 
relationship. For this program, we say the Ch2Sample1 class is dependent on the 
services provided by a JFrame object, because the Ch2Sample1 class sends mes¬ 
sages to the MyWindow object. We draw a dotted arrow from Ch2Sample1 to 
myWindow to indicate the dependency relationship, as shown in Figure 2.3 



Figure 2.2 The program diagram for the Ch2Sample1 program. 


Ch2Samplel 


z> myWindow : JFrame 


Figure 2.3 The program diagram for the Ch2Sample1 program that shows the dependency relationship. 
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We begin the explanation of the program from the following core five lines 
of code: 


j Fra 

me 

my Wi 

nd 

ow; 

my Wi 

ndow 

= new j 

F r a me () ; 

my Wi 

ndow. 

s et Si 

z e 

(300, 200); 

my Wi 

ndow. 

s et Ti 

11 

e (" My First 

my Wi 

ndow. 

s et Vi 

s i 

bl e ( t r u e ); 


We will explain the rest of the program in Section 2.2. These five lines of code 
represent the crux of the program, namely, an object-oriented program that uses 
objects. The rule to remember in using objects is as follows: 



hings to Remember 


To use an object in a program, first we declare and create an object, and then we 
send messages to it. 


In the remainder of this section, we will describe how to declare an object, 
create an object, and use an object by sending messages to the object. 

Object Declaration 

Every object we use in a program must be declared. An object declaration desig¬ 
nates the name of an object and the class to which the object belongs. Its syntax is 

ob j ect <c I ass name> <object names> ; 

declaration . 

syntax where <object names> is a sequence of object names separated by commas and 

<class name> is the name of a class to which these objects belong. Here’s how the 
general syntax is matched to the object declaration of the program: 


Class Name 

The class must be 
defined beforehand. 


Object Names 

One object is 
declared here. 


j F r a me 


myWi ndow; 


Here are more examples: 

Account checking; 

Customer john, jack, j i I I ; 

The first declaration declares an Account object named checking, and the second 
declaration declares three Customer objects. 
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identifier 


standard 

naming 

convention 


To declare an object as an instance of some class, the class must be defined 
already. First we will study how to use objects from system classes. Later in the 
book, we will show you how to define your own classes, from which you can create 
instances. 

When we declare an object, we must give it a name. Any valid identifier that 
is not reserved for other uses can be used as an object name. A Java identifier is a 
sequence of letters, digits, underscores (_), and dollar signs ($) with the first one 
being a nondigit. We use an identifier to name a class, object, method, and others. 
The following words are all valid identifiers: 

MyFirstApplication _ a g e 

FunTime H e I I o $ Wo r I d 

ComputeArea x12 3 

DEFAULT_VALUE velocity 

Upper- and lowercase letters are distinguished, so the following four identi¬ 
fiers are distinct: 

my Wi ndow mywi ndow 

MYwindow MYWI NDOW 

No spaces are allowed in an identifier, and therefore, the three lines 

Sample Program 
My First Application 
Program FunTime 

are all invalid identifiers. 

Since upper- and lowercase letters are distinguished, you can use robot as the 
name for an object of the class Robot. We name objects in this manner whenever 
possible in this book so we can easily tell to which class the object belongs. We fol¬ 
low the Java standard naming convention of using an uppercase letter for the hist 
letter of the class names and a lowercase letter for the first letter of the object names 
in this book. It is important to follow the standard naming convention so others who 
read your program can easily distinguish the purposes of identifiers. Programs that 
follow the standard naming convention are easier to read than those that do not. And 
remember that software maintenance is easier with easy-to-understand programs. 

When an identifier consists of multiple words, the Java naming convention 
dictates the first letter from every word will be capitalized, except the first word 
if the identifier is an object name. For example, we write MyMainWindow and 
myMainWindow for the class and object name, respectively. 



Follow the standard naming convention in writing your Java programs to 
make them easier to read. 


Table 2.2 in the Summaiy section summarizes the naming convention. 
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Object Creation 

No objects are actually created by the declaration. An object declaration simply 
declares the name (identifier) that we use to refer to an object. For example, the 
declaration 


new operator 


object creation 
syntax 


J F r a me my Wi n d o w; 

designates that the name myWindow is used to refer to a JFrame object, but the 
actual JFrame object is not yet created. We create an object by invoking the new 
operator. The syntax for new is 

<o b j e c t name> = new <c I ass name> ( <arguments> ) ; 


where <object names is the name of a declared object, <class names is the name of 
the class to which the object belongs, and <arguments> is a sequence of values 
passed to the new operation. Let’s match the syntax to the actual statement in the 
sample program: 


Object Name 

Name of the object 
we are creating 

myWindow = newjFrame ( ) ; 

Argument 

- No arguments 

are used here. 


Class Name 

An instance of this 
class is created. 


Figure 2.4 shows the distinction between object declaration and creation. 
Figure 2.5 shows the relationship between the UML-based program diagram and 
the state-of-memory diagram. The state-of-memory diagram borrows the notation 
from UML for consistency, but it is not a true UML diagram because it uses sym¬ 
bols and notations not found in UML. 

Now, consider the following object declaration and two statements of object 
creation: 


C u s t o me r c u s t o me r; 
customer = new Customer) ); 
customer = new Customer) ); 

What do you think will happen? An error? No. It is permissible to use the same 
name to refer to different objects of the same class at different times. Figure 2.6 



Instead of writing statements for object declaration and creation separately, we 
can combine them into one statement. We can write,for example, 

Student j ohn = new Student)); 

instead of 

Student j ohn; 
j ohn = new Student)); 
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Account account; 


account = new Account) ) ; 


State of Memory 

after (J) is executed 


account 


The identifier account is 
declared and space is 
allocated in memory. 


Account account; 


after (jT) is executed 



account = new Account) ) ; 


account 



An Account object is created 
and the identifier account is 
set to refer to it. 


Figure 2.4 Distinction between object declaration and object creation. 


account 



State-of-Memory 

Notation 


Program Diagram 
Notation 


The state-of-memory diagram uses the 
same UML notation, but it also includes 
^ symbols and notations not found in UML. ^ 


Figure 2.5 Relationship between the state-of-memory diagram and the program diagram notation. 


shows the state-of-memory diagram after the second new is executed. Since there 
is no reference to the first Customer object anymore, eventually it will be erased 
and returned to the system. Remember that when an object is created, a certain 
amount of memory space is allocated for storing this object. If this allocated but 
unused space is not returned to the system for other uses, the space gets wasted. This 
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Customer customer; 
customer = new Customer! ) ; 
customer = new Customer! ) ; 
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Created with the 
second new. 


Figure 2.6 The state after two new commands are executed. 


returning of space to the system is called deallocation, and the mechanism to deal- 
garbage locate unused space is called garbage collection. 

collection 

Message Sending 

After the object is created, we can start sending messages to it. The syntax for send¬ 
ing a message to an object is 

message- <0 b j e c t n a me > . <me t hod name> ( <arguments> ) ; 

sending syntax 

where <object name> is an object name, <method name> is the name of a method 
of the object, and <arguments> is a sequence of values passed to the method. In 
the sample program, we send the setVisible message with the argument true to 
the mainWindow object to make it appear on the screen. Once again, let’s match the 
components in the general syntax to the actual statement: 


Object Name 

Name of the object to which 
we are sending a message 


Method Name 

The name of the message 
we are sending 


myWindow . setVisible ( true ) 
Argument 

The argument we are passing - 

with the message 


Figure 2.7 shows the correspondence between message sending as repre¬ 
sented in the program diagram and in the Java statement. Because the object that 
receives a message must possess a corresponding method, we often substitute the 
expression sending a message with calling a method. We will use these expressions 
interchangeably. 
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Note: We can place method 
icons on either side of a 
^ class or instance icon. 


Program 

Diagram 


mvWindow:JFrame 


setVisible(true) 


Corresponding 
Java Statement 


myWindow 


setvisible ( true ) ; 


Figure 2.7 Correspondence between message sending as represented in the program diagram and in the 
actual Java statement. 


[Things to Remember 



The expression calling object O's method M is synonymous with sending message 
M to object O. 


Notice the argument for the setvisible message does not include double quotes 
as did the one for the setTitle message in the example shown on page 32. The argu¬ 
ment true is one of the two possible logical values (the other is false) used in Java 
programs. We will study more about the use of logical values later in the book, start¬ 
ing from Chapter 5. For now, it suffices to remember that there are two logical 
values— true and false —used for certain specific purposes. 

Passing true in the setvisible message makes the receiving object appear on 
the screen. Passing false makes the object disappear from the screen. So, for exam¬ 
ple, if we write 

myWi ndow. setVi si bl e(true); 
myWi ndow. setVi si bl e(fal se); 
myWi ndow. setVi si bl e(true); 

then myWindow will appear once, disappear, and then appear on the screen again. 
C Note : Because the computer will execute these statements so quickly, you may not 
notice any difference from the original program. See Exercise 25 on page 80.) 
reserved word The word true (and false) is called a reserved wore. It is an identifier that is 

used for a specific purpose and cannot be used for any other purpose, such as for the 
name of an object. 


P 


Quick 


CHECK 


1. Which of the following are invalid identifiers? 

a. one 

b. "Good Bye" 

c. 1234 

d. DecafeLattePI ease 
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e. $ h e I I o $ 

f. j AVA 

g. hello, there 

h. a c c 112 2 

i. 4 y o u 

j. _ d o Wo r k 

k. Wai t_For_Me 

2. What’s wrong with the following code? 

J F r a me my Wi n d o w () ; 

myWi ndow. setVi si bl e(true); 

3. Is there anything wrong with the following declarations? 

mai nWi ndow Mai nWi ndow; 

Account, Customer account, customer; 

4. Which of the following statements is valid? 

a. my F i r s t Wi n d o w. s e t Vi s i b I e ( "true" ) ; 

b. my F i r s t Wi n do w. s e t Vi si b I e ( true ) ; 


2.2 Program Components 

Now that we have covered the crux of the first sample program, let’s examine the 
rest of the program. The first sample application program Ch2Sample1 is composed 
of three parts: comment, import statement, and class declaration. These three parts 
are included universally in Java programs. 


I hings to Remember 

A Java program is composed of comments, import statements, and class 
declarations. 


You can write a Java program that includes only a single class declaration, but 
that is not the norm. In any nontrivial program, you will see these three components. 
We explain the three components and their subparts in this section. 


Comments 

In addition to the instructions for computers to follow, programs contain comments in 
which we state the purpose of the program, explain the meaning of code, and provide 
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any other descriptions to help programmers understand the program. Here’s the com¬ 
ment in the sample Ch2Sample1 program: 

: / * ; 

Chapter 2 Sample Program: Displaying a Window 

File: Ch2Sampl el.j ava 

L* 1 J 

import javax.swing,*; 
class Ch2Sampl el { 


public 

s 

t at 

i c 

VO 

i d 

ma 

i n(St 

r i n g [ ] 

args) { 

J F 

r a 

me 


my 

Wi n 

do 

w; 



my 

Wi 

n d o 

w 

= n 

ew 

J F 

r a me ( 

): 


my 

Wi 

n d o 

w. 

set 

Si z 

e( 

3 0 0, 

2 0 0 ) ; 


my 

Wi 

ndo 

w. 

set 

Ti t 

1 e 

( "My 

First 

java Program 

my 

Wi 

ndo 

w. 

set 

Vi s 

i b 

1 e(tr 

u e ) ; 



} 

} 


comment 

markers 


single-line 

comment 

marker 


A comment is any sequence of text that begins with the marker /* and termi¬ 
nates with another marker */. The beginning and ending comment markers are 
matched in pairs; that is, every beginning marker must have a matching ending 
marker. A beginning marker is matched with the next ending marker that appears. 
Any beginning markers that appear between the beginning marker and its matching 
ending marker are treated as part of the comment. In other words, you cannot put a 
comment inside another comment. The examples in Figure 2.8 illustrate how the 
matching is done. 

Another marker for a comment is double slashes //. This marker is used for a 
single-line comment marker. Any text between the double-slash marker and the end 
of a line is a comment. The following example shows the difference between mul¬ 
tiline and single-line comments: 


This i 

s 

a c o mme n 

three 

1 

nes of 

text. 



*1 



II This i 

s 

a c o mme n 

II This i 

s 

another 

II This i 

s 

a third 


wi t h 


c o mme n t 
c o mme n t 
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/* This is a comment on one line */ 


< 


/* 

*/ 

/* 

*/ 


Comment number 1 


Comment number 2 



Figure 2.8 How the beginning and ending comment markers are matched. 



hings to Remember 


Although not required to run the program, comments are indispensable in writing 
easy-to-understand code. 


javadoc The third type of comment is called a javadoc comment. It is a specialized 

comment comment that can appear before the class declaration and other program elements 

yet to be described in the book. We will explain more about javadoc comments in 
Chapter 7. 

Comments are intended for the programmers only and are ignored by the 
computer. Therefore, comments are really not necessary in making a program exe¬ 
cutable, but they are an important aspect of documenting the program. It is not 
enough to write a program that executes correctly. We need to document the pro¬ 
gram, and commenting the program is an important part of program documentation. 
Other parts of program documentation include program diagrams, programmers’ 
work logs, design documents, and user manuals. If you can write a program once 
and use it forever without ever modifying it. then writing a program with no com¬ 
ments may be tolerable. However, in the real world, using programs without ever 
making any changes almost never happens. For example, you may decide to add 
new features and capabilities or modify the way the user interacts with the program. 
Even if you don’t improve the program, you still have to modify the program when 
you detect some errors in it. Also, for commercial programs, those who change the 
programs are most often not the ones who developed them. When the time comes 
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header 

comment 

typical header 
comment for a 
beginning 
programming 
class 


for a programmer to modify his own or someone else’s program, the programmer 
must first understand the program, and program documentation is an indispensable 
aid to understanding the program. 

There are several different uses of comments. The first is the header comment. 
At the beginning of a program, we place a comment to describe the program. We 
characterize such a comment as a header comment We also may include header 
comments at the beginning of methods to describe their purposes. Depending on the 
length and complexity of programs, the description may range from short and sim¬ 
ple to long and very detailed. A typical header comment for a beginning program¬ 
ming class may look something like this: 



* Program: 

* 

* Author: 

* 

* 

* Wr i 11 e n: 

* 

* Course: 

* 

* 

* 


' > 

Text Editor NoteiTheuseofthe 

asterisks is in the style of 
javadoc, but this is not a 

Decafe Latte javadoc comment. 

decafe@1 atte. com* 

May 1, 2008 

Comp Sci 101 
Spring 2008 

Program Assign ment No. 7 


* Compiler: java 6,0 

* Platform: Wi ndows Vista 

* 


* 

* 

* 

* 

* 

* 

* 

* 

* 


Description: 

This is a simple text editor. The editor allows the user 
to save text to a file and read text froma file. The 
editor displays text using Courier font only and does not 
allow formatting ( e. g. , bold, italic, etc.). The editor 
supports standard editing functions Cut, Copy, and 
Paste, but does not support Undo, For mo re details, 
please refer to the TxEdi t Readme file. 


For your own programs, you should write header comments following the 
guideline provided by your instructor. For listing the sample programs in the book, 
we will include only the program name and a short description in the header com¬ 
ment, mainly for reference purposes. The header comment in the actual programs, 
available from our website, includes additional information. 
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Another use of comments is to explain code whose purpose may not be obvi¬ 
ous. Your aim is always to write easily understandable, self-explanatory program 
code. But at times this is not possible, and you should attach comment to code that 
is not so easy to understand. There also are times when the original code may not 
work as intended, and as a temporary measure, you modify the code slightly so the 
program will continue to work. You should clearly mark such modification with a 
comment, so you remember what you have done. If you did not put in an appropri¬ 
ate comment and later read your code without remembering about the modification, 
you would have no idea why you wrote such code. If you cannot understand your 
own code, imagine the frustration of other programmers (or your T.A. or instructor) 
trying to understand your modified code. 

Yet another use of comments is to identify or summarize a block of code. Sup¬ 
pose a program is divided into three major parts: getting input values from the user, 
performing computation by using those values, and displaying the computation re¬ 
sults. You can place comments at the top of each part to delineate the three major 
parts clearly. 

Remember that adding comments to a poorly designed program will not make 
it a better program. Your foremost goal is to develop a well-designed program that 
runs efficiently and is easy to understand. Commenting a program is only a means 
toward that goal, not a goal itself. In fact, excessive use of comments makes it 
harder to follow and understand a program. 



Always aim for self-explanatory code. Do not attempt to make poorly written 
code easier to read by comments. Good comments are not a substitute for 
good code. Bad code is bad, no matter how well your comments are written. 


Comment markers are useful in disabling a portion of a program. Let's say you find 
a portion that may be causing the program to crash, and you want to try out 
different code for the problem portion. Instead of replacing the whole problem 
portion with new code, you can leave the questionable code in the program by 
converting it into a "comment" with comment markers. You can remove the 
comment markers if you need this code later. 


Import Statement 

We develop object-oriented programs by using predefined classes, both system- 
and programmer-defined, whenever possible and defining our own classes when 
no suitable predefined classes are available. In Java, classes are grouped into 
packages, and the Java system comes with numerous packages. We also can logi¬ 
cally group our own classes into a package so they can be reused conveniently by 
other programs. 
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To use a class from a package, we refer to the class in our program by using 
the following format: 

<package name> . <c I ass name> 

For example, to use the Resident class in the dorm package, we refer to it as 
dorm. Resi dent 

dot notation which we read as “dorm dot Resident.” This notation is called lot notation. 

A package can include subpackages, forming a hierarchy of packages. In 
referring to a class in a deeply nested package, we use multiple dots. For example, 
we write 

j avax. swi ng.J Frame 

to refer to the class JFrame in the javax.swing package; that is, the swing package 
is inside the javax package. Dot notation with the names of all packages to which 
fully qualified a class belongs is called the class’s fully qualified name. Using the fully qualified 
name name of a class is frequently too cumbersome, especially when we have to refer 

to the same class many times in a program. We can use the import statement to 
avoid this problem. Here’s the original Ch2Sample1 program that uses the import 
statement: 



Chapter 2 Sample Program: Displaying a Window 
File: C h 2 S a mp lei. java 

*1 

Import Statement 

import javax swing *■ The import statement allows the program to 

.' refer to classes defined in the designated pack- 

class C h 2 S a mp I el { 

public static void mai n(Stri ng[] args) { 

j F r a me my Wi ndow; 

myWindow = new J F r a me ( ); 

myWi ndow. setSi ze(300, 200); 

myWi ndow. setTi tl e("My First java Program"); 

myWi ndow. s et Vi si bl e(true); 

} 


} 
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And here’s the same Ch2Sample1 program without the import statement: 



Chapter 2 Sample Program: Displaying a Window 
File: C h 2 S a mp lei. java 


class Ch2Sampl el { 


No import statement 


public static void main(String[] args) { 
f j a v a x. s wi ng. j F r a me myWi ndow; 

myWindow = new j avax. swi ng. J Frame (); 


Fully qualified names 


myWi ndow. setSi ze( 300, 200); 

my Wi ndow. s e t T i 11 e ( " My First java Program' * 1 ); 

myWi ndow. setVi si bl e(true); 


} 


Instead of using the expression javax.swing.JFrame to refer to the class, we 
can refer to it simply as 

j F r a me 

by including the import statement 

i mpo r t j a v a x. s wi ng. j F r a me; 

at the beginning of the program. Notice that the import statement is terminated by a 
semicolon. If we need to import more than one class from the same package, then 
instead of using an import statement for every class, we can import them all by 
using asterisk notation: 

i mport <pac kage name> . * ; 

For example, if we state 

i mport javax.swing.*; 
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then we are importing all classes from the javax.swing package. We use this asterisk 
notation in our sample program, even when we use only one of the many classes 
available in the javax.swing package. We could have used 

i mport j avax. swi ng. J Frame; 

but it is more conventional to use asterisk notation. Notice that the package names 
are all in lowercase letters. This is another standard Java naming convention. 
Chapter 4 includes greater discussion of packages. 


IfiJjTfWW When we say "import a package," it sounds as if we are copying all those classes 
WnjhjjjB into our programs.That is not the case. Importing a package is only a shorthand 
notation for referencing classes.The only effect of importing a package is the elim¬ 
ination of the requirement to use the fully qualified name. No classes are physically 
r\ copied into our programs. 


Class Declaration 

A Java program is composed of one or more classes; some are predefined classes, 
while others are defined by us. In the first sample program, there are two classes— 
JFrame and Ch2Sample1. The JFrame class is one of the standard classes, and the 
Ch2Sample1 class is the class we define ourselves. To define a new class, we must 
declare it in the program, or make a class declaration. The syntax for declaring the 
class is 

class <cI ass name> { 

<c I ass member decl arati ons> 

} 

where <class name> is the name of the class and <class member declarations> is a 
sequence of class member declarations. The word class is a reserved word used to 
mark the beginning of a class declaration. A class member is either a data value or 
a method. We can use any valid identifier that is not reserved to name the class. 
Here’s the class declaration in the sample Ch2Sample1 program: 


class 

declaration 



Chapter 2 Sample Program: Displaying a Window 
File: C h 2 S a mp lei. java 

*1 

import javax.swing,*; 
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class Ch2Sampl el { 

public static void mai n(Stri ng[] args) { 

j F r a me my Wi nd o w; 

my Wi n d o w = new J F r a me () ; 

myWi ndow. setSi ze( 300, 200); 

my Wi n do w. s e t T i 11 e ( " My First java Program' 1 ); 

myWi ndow. setVi si bl e(true); 




Class Declaration 

Every program 
must include at 
least one class. 


main class One of the classes in a program must be designated as the main class. The 

main class of the sample program is Ch2Sample1 . Exactly how you designate a class 
as the main class of the program depends on which Java program development tool 
you use. We will use the name of a main class to refer to a whole program. For 
example, we say the Ch2Sample1 class when we refer to the class itself, and we say 
the Ch2Sample1 program when we refer to the whole program. 

If we designate a class as the main class, then we must define a method called 
main, because when a Java program is executed, the main method of a main class is 
executed first. To define a method, we must declare it in a class. 

Method Declaration 

method The syntax for method declaration is 

declaration 

<modifiers> < r e t u r n type> < me t hod name> ( <parameters> ) { 

< me t hod body> 

} 

where <modifiers> is a sequence of terms designating different kinds of methods, 
<return type> is the type of data value returned by a method, <method name> is the 
name of a method, <parameters> is a sequence of values passed to a method, and 
<method body> is a sequence of instructions. Here’s the method declaration for the 
main method: 



I* 

Chapter 2 Sample Program: Displaying 
File: Ch2Sampl el.j ava 

*1 


ndow 


www.it-ebooks.info 









48 Chapter 2 Getting Started with Java 


import j avax. swi ng. *; 
class Ch2Sampl el { 

public static void mai n(Stri ng[] args) { 


J Fra 

me 

my Wi 

nd 

ow; 

my Wi 

ndow 

= new j 

F r a me ( ); 

my Wi 

ndow. 

s et Si 

z e 

(300, 200); 

my Wi 

ndow. 

s et Ti 

11 

e ( " My First 

my Wi 

ndow. 

s et Vi 

s i 

b 1 e ( t r u e ) ; 


: } 

} 


Method Declaration 

This declaration declares 
the main method. 


Let’s match these components to the actual method declaration of the sample 
program: 


Modifier 


Modifier 


ifi6r I | 


ifier |— 


public static 


H 


voi d 


Return Type 


H 


Method Name 


H 


main ( String! ] 


Parameter 


args ) { 


| JFrame myWindow; 
i myWindow = new JFrame( ) ; 
j myWindow. setSize( 300, 200) ; 

i myWindow. setTitle( "My First Java Program") ; 
j myWindow. setVisible( true); 


Method Body 

Consists of a sequence 
of instructions 


We do not explain the meanings of modifiers, return types, and parameters 
here. We will explain them in detail gradually as we progress through the book. For 
now, we ask you to follow a program template that we present next. 

A Program Template for Simple Java Programs 

The diagram in Figure 2.9 shows a program template for simple Java programs. You 
can follow this program template to write very simple Java programs. The structure 
of the sample program Ch2Sample1 follows this template. 


www.it-ebooks.info 


















2.3 Edit-Compile-Run Cycle 


49 


Comment 

Use a comment to 
describe the program. 

Import Statements 

Include a sequence of 
import statements. 

Class Name 

Give a descriptive 
name to the main class. 


Method Body 

Include a sequence 
of instructions. 



Figure 2.9 A program template for simple Java programs. 


2.3 Edit-Compile-Run Cycle 

We will walk through the steps involved in executing the first sample program, 
edit-compile- What we outline here are the overall steps in the lit-compile-run cycle common to 

run cycle an y j ava development tool you use. You need to get detailed instructions on how to 

use your chosen development tool to actually run programs. The steps we present in 
this section should serve as a guideline for more detailed instructions specific to 
your program development tool. Additional information on how to run Java pro¬ 
grams can be found in Appendix A. 

Step 1 

Type in the program, using an editor, and save the program to a hie. Use the name 
of the main class and the suffix .java for the filename. This hie, in which the pro¬ 
source file gram is in a human-readable form, is called a source file. 


Ch2Sample1.java 



Chapter 2 Sample Program: Displaying a Window 


File: C h 2 S a mp lei. java 

*/ 
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project file 
bytecode 
bytecode file 


Editor 


i mport 

j a 

v a 

x. s 

wi 

n g. *; 







class 

Ch 2 

5a 

mp 1 

el 

{ 







pub 

1 i c 

s 

t at 

i c 

void 

ma 

i n 

( 

St ri ng [ 

1 args 

{ 


J F 

r a 

me 


myWi n 

do 

w; 






my 

Wi 

n d o 

w 

= new 

J F 

r a 

me 

0; 




my 

Wi 

ndo 

w. 

set Si z 

e( 

30 

0, 

2 0 0 ) ; 




my 

Wi 

ndo 

w. 

s e t T i t 

1 e 

(" 

My 

First 

Java P r 

) g r a m 


my 

Wi 

ndo 

w. 

set Vi s 

i b 

1 e 

(t 

rue); 




} 

} 


(source file) 


Step 2 

Compile the source file. Many compilers require you to create a project file and then 
place the source hie in the project hie in order to compile the source hie. When the 
compilation is successful, the compiled version of the source hie is created. This 
compiled version is called bytecode, and the hie that contains bytecode is called a 
bytecode file. The name of the compiler-generated bytecode hie will have the suffix 
.class while its prefix is the same as the one for the source hie. 


Ch2Samplel.class 


Ch2Samplel.java 


Chapter 2 Sample Program: Displaying a Wini 
File: Ch2Sample.java 


import javax. swing.*; 

Class Ch2Samplel { 

public Static void mainf string!] args ) { 
JFrame myWindow; 
myWindow = n e W JFramef ) ; 


(source file) 


Compiler 


be 00 0 

0 

2 

0 

If 08 

OC 


07 

0 

0 








000010 

07 

00 

15 

07 

00 

13 

Oa 

00 

04 

00 

08 

Oa 

00 

03 

00 

07 


000020 

Oc 

00 

19 

00 

lc 

Oc 

00 

17 

00 

14 

01 

00 

04 

74 

68 

69 

.thi 

000030 

73 

01 

00 

Od 

43 

6f 

6e 

73 

74 

61 

6e 

74 

56 

61 

6c 

75 

s...ConstantValu 

000040 

65 

01 

00 

12 

4c 

6f 

63 

61 

6c 

56 

61 

72 

69 

61 

62 

6c 

e. ..LocalVariabl 

000050 

65 

54 

61 

62 

6c 

65 

01 

00 

Oe 

6d 

79 

46 

69 

72 

73 

74 

eTable...myFirst 

000060 

50 

72 

6f 

67 

72 

61 

6d 

01 

00 

Oa 

45 

78 

63 

65 

70 

74 

Program...Except 

000070 

69 

6f 

6e 

73 

01 

00 

Of 

4c 

69 

6e 

65 

4e 

75 

6d 

62 

65 

ions...LineNumbe 

000080 

72 

54 

61 

62 

6c 

65 

01 

00 

Oa 

53 

6f 

75 

72 

63 

65 

46 

rTable...Source 

000090 

69 

6c 

65 

01 

00 

Oe 

4c 

6f 

63 

61 

6c 

56 

61 

72 

69 

61 

ile...LocalVaria 

OOOOaO 

62 

6c 

65 

73 

01 

00 

04 

43 

6f 

64 

65 

01 

00 

Ob 

49 

20 

bles...Code...1 

OOOObO 

4c 

6f 

76 

65 

20 

4a 

61 

76 

61 

01 

00 

13 

4a 

61 

76 

61 

Love Java...Java 

OOOOcO 

42 

6f 

6f 

6b 

2f 

4d 

65 

73 

73 

61 

67 

65 

42 

6f 

78 

01 

Book/MessageBox. 

OOOOdO 

00 

15 

28 

4c 

6a 

61 

76 

61 

2f 

6c 

61 

6e 

67 

2f 

53 

74 

. .( Ljava/lang/St 

OOOOeO 

72 

69 

6e 

67 

3b 

29 

56 

01 

00 

10 

6a 

61 

76 

61 

2f 

6c 

ring;) V...java/1 

OOOOfO 

61 

6e 

67 

2f 

4f 

62 

6a 

65 

63 

74 

01 

00 

04 

6d 

61 

69 

ang/Object...mai 

000100 

6e 

01 

00 

07 

64 

69 

73 

70 

6c 

61 

79 

01 

00 

16 

28 

5b 

n. . .display. . .( [ 

000110 

4c 

6a 

61 

76 

61 

2f 

6c 

61 

6e 

67 

2f 

53 

74 

72 

69 

6e 

Ljava/lang/Strin 

000120 

67 

3b 

29 

56 

01 

00 

06 

3c 

69 

6e 

69 

74 

3e 

01 

00 

10 

g; )V.-■<init>... 

000130 

4c 

6d 

79 

46 

69 

72 

73 

74 

50 

72 

6f 

67 

72 

61 

6d 

3b 

LmyFirstProgram; 

000140 

01 

00 

13 

6d 

79 

46 

69 

72 

73 

74 

50 

72 

6f 

67 

72 

61 

...myFirstProgra 

000150 

6d 

2e 

6a 

61 

76 

61 

01 

00 

03 

28 

29 

56 

01 

00 

04 

61 

m.java...( )V...a 

000160 

72 

67 

73 

01 

00 

13 

5b 

4c 

6a 

61 

76 

61 

2f 

6c 

61 

6e 

rgs. . .[ Ljava/lan 

000170 

67 

2f 

53 

74 

72 

69 

6e 

67 

3b 

00 

00 

00 

02 

00 

03 

00 

g/String;. 


(bytecode file) 


When any error occurs in a program, an error message will be displayed. If the 
sample program contains no errors in syntax, then instead of an error message, you 
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will get nothing or a message stating something like "Compiled successfully." To see 
what kind of error messages are displayed, try compiling the following program. 
We purposely introduced three errors. Can you find them? Make sure to compile the 
correct Ch2Sample1 again before you proceed to the next step. 

import javax.swing.*; 

class Ch2SampI el { 

public static void mainf Stri ng[]args ) { 
myWindow = new J F r a me ( ) ; 
myWi ndow. setSi ze( ) ; 

myWi ndow. setTi tl e( "My First java Program"); 
my Wi ndow. s et Vi si bl e ( t r u e ) 

} 

} 

compilation Errors detected by the compiler are called compilation errors. Compilation 

error errors are actually the easiest type of errors to correct. Most compilation errors are 

due to the violation of syntax rules. 



It would be really nice if you get an error such as "Declaration for myWindow is 
missing" when you compile the bad version of the Ch2Sample1 program shown 
here. Unfortunately, you won't receive such an informative and precise error mes¬ 
sage. When you actually compile the bad version, you will get a cryptic error mes¬ 
sage "cannot find symbol" four times (the number of times the object name 
myWindow appears in the program). The compiler can detect an error but it 
cannot generally pinpoint the cause of the error. As you gain more experience in 
programming, you will gradually become more adept in finding the cause of 
errors from these cryptic error messages. 


qiou 

zJ Might 
Want to 

Know 


When you use an advanced Java IDE tool such as Eclipse (www.eclipse.org) or 
NetBeans (www.netbeans.org), you do not have to perform the compilation step 
explicitly. Its high-power editor monitors your source code continually as you type 
and highlights any error. 
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Step 3 

Execute the bytecode file. A Java interpreter will go through the bytecode file and 
execute the instructions in it. If your program is error-free, a window will appear on 
the screen. 


Editor 


Ch2Samplel.class 



M.d.nfiil.dl’a 




Running Program 


If an error occurs in running the program, the interpreter will catch it and stop 
execution error its execution. Errors detected by the interpreter are called execution errors. If you 
did not see the expected results, go back to the previous steps and verify that your 
program is entered correctly. If you still do not see the expected results, then most 
likely your development environment is not set up correctly. Please refer to other 
sources of information for further help. 


CUou 
'J Might 
Want to 

Know 


Unlike machine-language instructions, or machine code, Java bytecode is not tied 
to any particular operating system or CPU. All we need to run the same Java pro¬ 
grams on different operating systems is the Java interpreters for the desired oper¬ 
ating systems. Currently, there are Java interpreters for Windows, Mac, Unix, and 
other operating systems. A Java interpreter is also called a Java Virtual Machine 
(JVM) because it is like a virtual machine that executes bytecode, whereas a CPU is 
a real machine that executes machine code. 


2.4 Sample Java Standard Classes 

Eventually, you must learn how to define your own classes from which you create 
many instances. But before you do that, you must first master how to use existing 
classes. To this end, we will introduce seven standard classes here (in two of which 
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we only mention their names). We have two objectives in choosing these classes. 
First, we will reinforce and illustrate the core object-oriented programming con¬ 
cepts introduced in Chapter 1 with the actual Java statements that use these classes. 
Second, you will be able to start writing nontrivial Java programs using these 
classes. We do not want to overwhelm you, so we will cover only the basic opera¬ 
tions of these classes, enough to get you started. We will discuss additional capabil¬ 
ities of these classes as we progress through the textbook. 

Although we will scratch only the surface of these classes in this section, 
what we provide here should serve as a foundation for you to delve more deeply 
into these classes. For a more detailed description, please consult the documenta¬ 
tion for the standard classes. The documentation for the standard classes is com¬ 
monly called Java API documentation, where API stands for application program¬ 
ming interface. 



hinqs to Remember 


To become a good object-oriented programmer, first you must learn how to use 
predefined classes. 



Please do not get alarmed by the number 
Although we cover many standard classes 
basic operations, so we won't overwhelm 
documentation can be located online at 

http://java.sun.eom/javase/6/docs/api 


of standard classes we introduce here, 
at once, we limit ourselves to the most 
you with too much information. Their 


console 

window 

System.out 


standard 

output 


2.4.1 Standard Output 

When a program computes a result, we need a way to display this result to the 
user of the program. One of the most common ways to do this in Java is to use 
the console window. The console window is also called the standard output 
window. We output data such as the computation results or messages to the con¬ 
sole window via System.out. The System class includes a number of useful class 
data values. One is an instance of the PrintStream class named out. Since this is 
a class data value, we refer to it through the class name as System.out, and this 
PrintStream object is tied to the console window (there’s exactly one console 
window per program). Every data item we send to System.out will appear on this 
console window. We call the technique to output data by using System.out the 
standard output. 

We use the print method to output a value. For example, executing the code 

System, out. print) "Hello, Dr. Caffeine,"); 
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Note 

Depending on the tool you 
use, you may see additional 
text such as 

Press any key to continue... 

or something similar to it. We 
will ignore any text that may be 
displayed automatically by the 
system. 


Figure 2.10 Result of executing System.out.print("Hello, Dr. Caffeine."). 


will result in the console window shown in Figure 2.10. The actual appearance of 
the console window will differ depending on which Java development tool we use. 
Despite the difference in the actual appearance, its functionality of displaying data 
is the same among different Java tools. 



hinas to Remember 


System.out refers to a PrintStream object we use to output data to the console 
window. The actual appearance of the console window depends on which Java 
tool we use. 


The print method will continue printing from the end of the currently dis¬ 
played output. Executing the following statements will result in the console window 
shown in Figure 2.11. 


Code 


System. out .print ( "How do you do? "); 
System. out .print ( "My name is "); 
System.out.print ( "Seattle Slew." ) ; 


Output 


How do you do? My name is Seattle Slew. 


Because the actual appearance of the console 
window is different depending on the Java 
development tool you use, we use a generic 
picture for the console window in the diagrams. 


Figure 2.11 Result of executing three consecutive print methods. The print method continues the printing 
from the currently displayed output. 
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Code 


System.out.printIn ( "How do you do? "); 
System.out.println( "My name is "); 
System.out.println( "Seattle Slew." ) ; 


Output 


How do you do? 
My name is 
Seattle Slew. 


Figure 2.12 Result of executing three consecutive println methods.The println method will skip to the next 
line after printing out its argument. 


System. 

out 

p r i 

nt 

"How do 

you do? 

System. 

out 

p r i 

nt 

"My n a me 

is " ) ; 

System. 

out 

p r i 

nt 

11 S e a 111 e 

Slew." 


Notice that they all appear on the same line. If we want them to appear on individual 
lines, we can use the println method instead of print. The word println is a short¬ 
hand for “print line.” Figure 2.12 shows the effect of the println method. 

This concludes our quick introduction to System.out. We will be gradually in¬ 
troducing additional techniques of outputting to the console window as they are 
needed. 


Quick 

CHECK 


1. Write a Java statement to display the text I Love Java in the console window. 

2. Write statements to display the following shopping list in the console window. 
Don’t forget to include blank spaces so the item names appear indented. 

Shopping List: 

Apple 

Banana 

Low- f at Mi I k 


2.4.2 String 

The textual values we passed to the print method or the constructor of the JFrame 
class are instances of the String class. A sequence of characters separated by double 
quotes is String constants. As String is a class, we can create an instance and give it 
a name. For example. 

String n a me; 

name = new String! “Jon java' 1 ); 
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will result in a situation as follows: 


name 


: String 


Jon Java 



Unlike in other classes, the explicit use of new to create an instance is optional 
for the String class. We can create a new String object, for example, in this way: 

String n a me; 
n a me = " Decaf e Latte"; 

There are close to 50 methods defined in the String class. We will introduce 
substring three of them here: substring, length, and indexOf. We can extract a substring from 

a given string by specifying the beginning and ending positions. For example, 

String text; 

text = "Espresso"; 

System, out. pri ntftext. substri ng(2, 7)); 
will display the dialog shown in Figure 2.13. 

method Notice the use of method composition in the last statement, where the result of 

composition a method call is used as an argument in another method call. In the statement 

System, out.print (text.substrings, 7)); 

the result of method call 

text, substri ng ( 2, 7) 


Code 


String text; 
text = "Espresso"; 

System.out.print(text.substring(2,7)); 


Output 


press 


Figure 2.13 Result of extracting and displaying the substring of "Espresso" from index position's 2 to 6. 
The index position of the first character in a string is 0. 
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String 

text; 

text = 

"Espresso" ; 



Figure 2.14 Individual characters in a string are numbered from 0. 

is passed as an argument when calling the showMessageDialog method. The sample 
statement is equivalent to 

String tempStr; 

tempStr = text. substrings,7); 

System, out. print(tempStr); 

Individual characters in a String object are indexed from 0, as illustrated in 
Figure 2.14. The first argument of the substring method specifies the position of the 
first character, and the second argument specifies the value that is 1 more than the 
position of the last character. Figure 2.15 shows how the substring method works. 
Here are some more examples: 


text.substri 

ng ( 6, 8 

-► 

"so" 

text.substri 

ng ( 0, 8 

-► 

"Espresso" 

text.substri 

ng ( 1, 5 

- 

“ s p r e 11 


An error will result if you pass invalid arguments, such as negative values, the sec¬ 
ond argument larger than the number of characters in a string, or the first argument 
larger than the second argument. 


01234567 



text.substring(2, 

t 


0 12 3 


7) 

4 



Figure 2.15 The effect of the substring method is shown. Notice that a new string is created, and the 
original string remains intact. 
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We can find out the number of characters in a String object by using the length 
method. For example, if the name text refers to a string Espresso, then 

text. length!) 

will return the value 8, because there are eight characters in the string. Here are 
some more examples: 



t ext 1 = ""; 
t e x 12 = "Hello"; 
t e x 13 = "Java"; 

t ext 1.Iengt h( ) 

t ext 2. Iengt h( ) 

t ext 3.Iengt h( ) 


/ / e mp t y string 


-► 0 
-► 5 

-► 4 


To locate the index position of a substring within another string, we use the 
indexOf itldexO ] method. For example, if the name text refers to a string I Love Java, then 

text.i ndexOf ( "Love" ) 

will return the value 2, the index position of the first character of the designated 
string Love. If the searched substring is not located in the string, then -1 is returned. 
Notice that the search is done in a case-sensitive manner. Thus, 

text, i ndexOf ( 11 j ava" ) 

will return -1. If there is more than one occurrence of the same substring, the index 
position of the first character of the first matching substring is returned. Here are 
some more examples: 





3 

7 

21 


t 

ext 

= "1 

Lov 

e java and 

java loves 

me. " ; 

t 

ext. 

i nde 

xOf ( 

" J " ) 

-► 

7 

t 

ext. 

i nde 

xOf ( 

11 1 o v e " ) 

-► 

21 

t 

ext. 

i nde 

xOf ( 

" o v e " ) 

-► 

3 

t 

ext. 

i nde 

xOf ( 

" ME" ) 

-► 

- 1 
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Beyond the three methods we cover here and the remaining methods of the 
string String class, we have one very useful string operation in Java called string concate- 

concatenation nation. We can create a new string from two strings by concatenating the two 

strings. We use the plus symbol (+) for string concatenation. Here are the examples: 





t e x 11 = " 

J on"; 





t e x 12 = " 

J a v a 11 

: 

t ext 1 

+ 

t ext 2 



" J on) a v a 11 

t ext 1 

+ 

" " + 

t ext 2 - 


"Jon java' 1 

"How 

a r e 

you, 

" + t e x 11 + 11 ?" 








"How are you 


The sample class Ch2StringProcessing divides the given full name into the first 
and last names and displays the number of letters in the last name. 


I* 

Chapter 2 Sample Program: Simple String Processing 
File: Ch2Stri ngProcessing.j ava 

*/ 


class Ch2Stri ngProcessi ng { 

public static void main(String[] args) { 

String f u I I N a me, firstName, I a s t N a me, space; 

f u I I N a me = new S t r i ng (" Dec a f e Latte' 1 ); 
space = new String!" " ) ; 

firstName = ful I Name, substri ng(0, fullNa me, index Of (space)); 
lastName = ful I Name, substri ng(ful I Name, i ndexOf(space) + 1, 

ful I Name. I ength()); 

System, out. printlnf" Full Name: " + ful I N a me ) ; 

System, out. pri ntl n("Fi rst: " + f i r s t N a me ); 

System, out. printlnf" Last: " + lastName); 

System, out. pri ntl n("Your last name has " + lastNa me. length! ) 

+ " characters. 1 '); 


} 


} 
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w 

Quick 

CHECK 

V 


1. What will be the value of mystery when the following code is executed? 

String text, mystery; 

text = " mo c h a c h a i latte"; 
mystery = text, substri ng( 1, 5); 

2. What will be displayed on the message dialog when the following code is 
executed? 

String text = "I, Claudius"; 

System, out. printlnftext. index Of ("I") ); 

3. What will be displayed on the message dialog when the following code is 
executed? 

String text = "Augustus"; 

System, out. pri ntl n ( text. I e n g t h ( )) ; 

4. What will be the value of text3 when the following code is executed? 

String t e x 11 = "a 11 + " b" ; 

String t e x 12 = " c “ ; 

String t e x 13 = textl + t e x 12 + textl; 


2.4.3 Date and SimpleDateFormat 

The Date class is used to represent a time instance to a millisecond (one-thousandth 
of a second) precision. This class is in the java.util package. When a new Date 
object is created, it is set to the time it is created (the current time is determined by 
reading the time maintained by the operating system on your machine). The Date 
class includes the toString method that converts its internal format to a string repre¬ 
sentation, which we can use to display the time. For example, executing the code 

Date today; 

today = new D a t e ( ); 

System, out. pri ntl n(today. toStri n g ()) ; 

will display the current time in this format: 

Thu Dec 18 18:16:56 PST 2008 

Notice that the current time, when converted to a string format, includes the 
date information also. Internally, the time is kept as an elapsed time in milliseconds 
since the standard base time known as the epoch, which is January 1, 1970, 
00:00:00 GMT (Greenwich Mean Time). 
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C[\ou 

-J Might 
Want to 

Know 


Why is the class called Date when its purpose is to keep track of time? The reason is 
historical. In the older versions of Java, prior to JDK 1.1, the Date class was indeed 
used to manipulate the year, month, and day components of the current time. 
However, the way they are implemented was not amenable to internationalization. 
With the newer versions of Java, we use the GregorianCalendar class for date 
manipulation.The GregorianCalendar class is explained in Chapter 3. 


If we do not like the default format, say we want to display only the month and 
year or only the hours and minutes in the AM/PM designation, then we can use the 
SimpleDateFormat class. This class is in the java.text package. For example, if we 
want to display the month, day, and year in the MM/dd/yy shorthand format, such 
as 07/04/08, we write 

Dat e today; 

Si mp I e Da t e Fo r ma t s df; 

today = new Dat e( ) ; 

sdf = new Si mpl eDateFormat ( "MM/dd/yy" ) ; 

System, out. pri ntl n(sdf . format(today) ); 

If today is June 28, 2008, the code will display the date as 

06/28/08 

Notice the format designation is done by passing the formatting string when a 
new SimpleDateFormat object is created. The letters in the formatting string are case- 
sensitive. The formatting string in this example must be MM/dd/yy, and the letters d 
and y must be in lowercase. By increasing the number of formatting letters, we can 
change the length of the information, say, 2008 instead of 08. In case of the month, 
we change it from the number to a name. For example, when we change sdf to 

sdf = new Si mpl eDateFormat("MMMM dd, y y y y" ) ; 
the dialog will display 

June 28, 2008 

If we want to display which day of the week today is, we can use the letter E as in 

Dat e today; 

S i mp I e Da t e F o r ma t sdf; 

today = new Dat e( ) ; 

sdf = new S i mp I e Da t e F o r ma t ( " E E E E" ) ; 

System, out. pri ntl n (" Today is " + sdf.format(today)); 
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Some common formatting symbols for SimpleDateFormat and their 
meanings. Please check the Java API documentation for full details. 


Symbol 

Meaning 

Value 

Sample 

y 

Year 

Number 

yyyy -> 2008 

M 

Month in year 

Text or number 

MM —> 10 

MMM —> Oct 

MMMM —> October 

d 

Day in month 

Number 

dd —> 20 

D 

Day in year 

Number 

DDD -> 289 

h 

Hour in AM/PM 

Number 

hh —> 09 

H 

Hour in day (0-23) 

Number 

HH —> 17 

a 

AM/PM marker 

Text 

a —> AM 

m 

Minutes in hour 

Number 

mm -> 35 

s 

Seconds in minute 

Number 

ss—>54 

S 

Millisecond 

Number 

mmm —> 897 

E 

Day in week 

Text 

E —> Sat 

EEEE —> Saturday 


Table 2.1 lists the common letters used in the formatting for SimpleDate¬ 
Format. For more details, please consult the Java API documentation. 



Table 2.1 is provided solely for the purpose of quick reference when you start 
using the class in real programs. Nobody expects you to remember all those sym¬ 
bols. What is important here is for you to grasp the key OOP concepts and the 
fundamental way in which objects and classes are used, not to memorize minute 
details that nobody remembers. 


If you do not pass any string when creating a new SimpleDataFormat object, 
the default formatting is used. The sample Ch2DateDisplay class displays today’s 
date, using the default and programmer-designated format. 



Chapter 


Sample Program: Displays Formatted Date Information 


File: C h 2 Date Display, java 

*/ 
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import java,util.*; II for Date 

import java,text.*; //for Si mpl eDateFormat 

class Ch 2 Date Display { 

public static void mai n(Stri ng[] args) { 

Date today; 

Si mpl eDateFormat s i mp I e DF1, 
si mpl e DF 2 ; 

today = new Date(); 

si mpl eD F1 = new Si mpl eDateFormat( ); 

si mpl e D F 2 = new S i mp I e Dat eF o rmat ("EEEE MMMM dd, y y y y" ) ; 

//Default short format display 

System, out. p r i n 11 n ( " Today is " + si mpl eDFl. format(today) ); 

/ / P r o g r a mme r-designated long for mat display 

System, out. p r i n 11 n ( " Today is " + si mpl eDF2. format(today) ); 

} 

} 


Quick 

CHECK 


1. Write a code fragment to display today’s date in the 07-04-2008 format. 

2. What will be displayed on the message dialog when the following code is 
executed if today is July 4, 1776? 

Date today; 

Si mpl eDat eFor mat sdf; 

today = new D a t e ( ) ; 

sdf = new Si mpl eDateFormat("MMM dd, y y y y" ) ; 

System, out. p r i n 11 n (" Today is " + sdf.format(today)); 


System.in 
standard input 
console input 


Scanner 


2.4.4 Standard Input 

Analogous to System.out for output, we have System.in for input. We call the tech¬ 
nique to input data using System.in standard input. System.in accepts input from 
the keyboard. We also use the term console input to refer to standard input. Using 
System.in for input is slightly more complicated than using System.out for output. 
System.in is an instance of the InputStream class that provides only a facility to 
input 1 byte at a time with its read method. However, multiple bytes are required to 
represent common types of data such as strings. The Scanner class from the java.util 
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package provides a necessary input facility to accommodate various input routines. 
We limit our discussion here to input of string values. We extend our discussion to 
input of numerical values in Chapter 3. 

To input data from the standard input by using a Scanner object, we first cre¬ 
ate it by passing System.in as follows: 

import java.util.*; 

Scanner scanner; 

scanner = new ScannerfSystem. in); 

Once we have a Scanner object, then we can input a single word by using its next 
method. Here’s code to input the first name of a person: 

Scanner scanner = new Scanner ( System, in); 

String firstName; 

//prompt the user for input 

System, out. print) " Enter your first name: 11 ) ; 

firstName = scanner. nextf ); 

System, out. pri ntl n("Ni ce to meet you, " + f i r s t N a me + " . " ) ; 

The user interaction of this sample code is shown in Figure 2.16. In the dia¬ 
gram, the characters entered by the user are displayed in the console window as they 
are typed in, so the user can see what’s been entered. Printing out the values just en- 
echo printing tered is called echo printing The string input is processed until the Enter (or Return) 
key is pressed, so we can erase the characters by pressing the Backspace key while 
entering the data. 


System.out.print ( "Enter your first name: "); 
firstName = scanner.next ( ); 

System.out.println ( "Nice to meet you, " + firstName + 


Enter your first name: George (ENTEEt) 
Nice to meet you, George. 


This is entered by the user and echo 
printed by the system.To distinguish 
the input and output in the diagram, the 
input is displayed in a different color. 

The console window displayed by 
your Java tool may or may not use 
^ a different color for echo printing. 


This icon shows the pressing of 
the Enter (Return) key. 


Figure 2.16 Sample interaction using System.in with Scanner and System.out. Keyboard input is echo- 
printed in the console window. 
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Now let’s consider the case in which we want to input both the first name 
and the last name. We can follow the sample code and input them one by one as 
follows: 


Scanner scanner = new Scanner! Syst em. in); 

String firstName, lastName; 

System, out. print! "Enter your first name: "); 
firstName = scanner. next! ); 

System, out. print! “Enter your last name: "); 
lastName = scanner. next! ): 

System, out. println!" Your name is " + firstName + 
'" + I a s t N a me + ". " ); 


Enter your first name: George ( enter) 

Enter your last name: Washington ( enter) 

Your name is George Washington. 

What can we do if we want input both the first name and the last name 
together as a single input? Consider the following (wrong) code: 

Scanner scanner = new Scanner!System, in); 

String fullName; 

System, out. print! "Enter your first and last name: "); 
full N a me = scanned next! ): 

System, out. pri ntl n("Your n a me is " + f u I I N a me + ". " ) ; 

Here’s a sample interaction of a user entering both the first name and the last name 
on a single line: 


Enter your first and last name: George Washington ( enter) 
Your name is George. 

What happened to the last name? The blank space between the first name and the 
last name is treated as a delimiter. So the system has accepted the characters up to, 
but not including, the blank space as the input value. Because we know there are 
first and last names, we can input them individually as follows: 

Scanner scanner = new Scanner! Syst em. in); 

String first, last; 

System, out. print! "Enter your first and last name: "); 
first = scanner. next! ); 
last = scanner. next! ) ; 
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System, out. pri ntl n("Your n a me is " + first + " 

+ I a s t + " . 


Enter your first and last name: George Washington (enter) 
Your name is George Washington. 


Instead of treating each word individually, it is possible to enter a set of words 
as a single input. To do so, we must reset the delimiter to other than the blank space. 
Any character can be set as a delimiter, but since we want to input the whole line as a 
single input, it is most reasonable to set the delimiter to the Enter key. Here’s how we 
change the delimiter to the Enter key and accept the complete line as a single input: 

Scanner scanner = new ScannerfSystem. in); 

String lineSeparator 

= System. getProperty(“l i ne, separator"); 

scanner, use Del i mi t e r ( I i neSeparator); 

String quote; Note we're using println here. 

System, out. pri ntl n (" Enter your favorite quote: "); 

quote = scanner. next) ); 

System, out. pri ntl n (" You entered: " + quote); 


Enter your favorite quote: 

There never was a good war or a bad peace, (enter) 

You entered: There never was a good war or a bad peace, 

We override the default delimiter by calling the useDelimiter method and pass 
the appropriate argument. We use the class method getProperty of the System class 
to retrieve the actual sequence of characters for the Enter key that is specific to the 
platform which our program is running. For the Windows platform, for instance, we 
can call the useDelimiter method as 

scanner. useDel i mi ter("\r\n"); 

But such code is guaranteed only to work on the Windows platform. It may or may 
not work on other platforms. To make the code general enough to work on all plat¬ 
forms, we use System.getProperty. Incidentally, the backslash character (\) is called 
a control character or an escape character. We’ll examine the use of control char¬ 
acters later in the book. 

Let’s summarize what we have learned in this section by writing two sample 
programs. The first program will display a greeting after reading a person’s name. The 
greeting will display only the person’s first name even when the full name is entered. 
This means entering the input, say, John or John Smith, will result in the same display. 

Hi, John. Nice to meet you. 
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To achieve this behavior, we will use the default delimiter for the string input so that 
only the characters up to the first space is entered. Here’s the program: 


/ * 

Chapter 2 Sample Program: 

Reads a person's name and displays a greeting. 

File: Ch2Greetings.j ava 

*/ 

import java,util.*; 
class C h 2 G r e e ti ngs { 

public static void main(String[] args) { 

String firstName; 

Scanner scanner = new Scanner! System, in); 

S y s t e m. o u t. p r i n t (“What is your n a me ?" ) ; 

firstName = scanner. next( ); II accept characters up to, but not 

//including, the first space 

System, out. p r i n 11 n (" Hi, " + firstName + " . Nice to meet you."); 

} 

} 


The second program will accept the person’s full name and display the name 
in reverse. Although it is a standard in Western countries to state our full name in the 
order of first and last names (e.g., Paul Revere), filing of our information, such as 
medical records, is almost always done in the order of last and first names (e.g., 
Revere, Paul). The program will display the following message: 

Your medical record is filed under <1 a s t >, <first>. 

where <last> and <first> are replaced by the actual first and last names entered by the 
user. For example, if the user enters Samuel Adams, the program will display 

Your medical record is filed under Adams, Samuel. 

Here we will again use the default delimiter for string input, and we accept the 
first and the last names separately as explained in this section. 
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Chapter 2 Sample Program: Input first and last names and display the 

name in the format of last name, first name 


File: Ch2RecordFiIi ng.j ava 

*/ 


import java,util.*; 

class Ch2RecordFiling { 

public static void main(String[] args) { 

String fi r s t N a me, lastName; 

Scanner scanner = new Scanner ( Syst em. in); 

System, out.print (“Your full name: "); 

firstName = scanner. next) ); 
lastName = scanner. next( ); 

System, out. p r i n 11 n ( " Your medical record is filed under " + 
I a s t N a me + ", " + fi r s t N a me + ". " ) ; 


} 


} 


Quick 

CHECK 


1. Write a code to input the last name of a user. 

2. Show the content of the console window when the following code is executed 
and the text Barbaro is entered: 

Scanner scanner = new Scanner(System. in); 

String winner; 

System, out. pri nt( 

"Enter the name of the derby winner: "); 
winner = scanner. next( ); 

System, out. pri ntl n(" 2006 Kentucky Derby Winner is " 

+ n a me + ". " ) ; 
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2.5 Sample Development 


Printing the Initials 

Now that we have acquired a basic understanding of Java application programs, let's 
write a new application. We will go through the design, coding, and testing phases of the 
software life cycle to illustrate the development process. Since the program we develop 
here is very simple, we can write it without really going through the phases. However, it is 
extremely important for you to get into a habit of developing a program by following the 
software life cycle stages. Small programs can be developed in a haphazard manner, but 
not large programs. We will teach you the development process with small programs first, 
so you will be ready to use it to create large programs later. 

We will develop this program by using an incremental development technique, 
which will develop the program in small incremental steps. We start out with a bare- 
bones program and gradually build up the program by adding more and more code to 
it. At each incremental step, we design, code, and test the program before moving on 
to the next step.This methodical development of a program allows us to focus our at¬ 
tention on a single task at each step, and this reduces the chance of introducing errors 
into the program. 

Problem Statement 

We start our development with a problem statement. The problem statement for our 
sample programs will be short, ranging from a sentence to a paragraph, but the problem 
statement for complex and advanced applications may contain many pages. Here's the 
problem statement for this sample development exercise: 

Write an application that asks for the user's first, middle, and last names and 

replies with the user's initials. 

Overall Plan 

Our first task is to map out the overall plan for development. We will identify classes nec¬ 
essary for the program and the steps we will follow to implement the program. We begin 
with the outline of program logic. For a simple program such as this one, it is kind of 
obvious; but to practice the incremental development, let's put down the outline of pro¬ 
gram flow explicitly. We can express the program flow as having three tasks: 

1. Get the user's first, middle, and last names. 

2. Extract the initials to formulate the monogram. 

3. Output the monogram. 

Having identified the three major tasks of the program, we will now identify the 
classes we can use to implement the three tasks. First, we need an object to handle 
the input. At this point, we have learned about only the Scanner class, so we will use it 
here. Second, we need an object to display the result. Again, we will use System.out, as 
it is the only one we know at this point for displaying a string value. For the string 
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manipulation, we will use the String class. Finally, we will use these classes from the main 
class, which we will call Ch2Monogram. Let's summarize these in a design document: 



Design Document: Monogram 

Class 

Purpose 

Ch 2 Mo nogram 

The main class of the program. 

Scanner 

The next method is used for getting the full name. 

St ri ng 

The class is used for string manipulation, extracting initials 
from the first, middle, and last names. 

(Pri ntStream) 

The standard output window is used for displaying the resulting 

System, out 

monogram. 


The program diagram of Ch2Monogram is shown in Figure 2.17. Keep in mind that 
this is only a preliminary design. Although we are not going to see any changes made to 
this design document because this sample application is very simple, changes to the 
design document are expected as the programs we develop become larger and more 
complex. The preliminary document is really a working document that we will modify 
and expand as we progress through the development steps. 



Figure 2.17 The program diagram for Ch2Monogram. 
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develop¬ 
ment steps 


Before we can actually start our development, we must sketch the steps we will fol¬ 
low to develop the prog ram.There is more than one possible sequence of steps to develop 
a program, and the number of possible sequences will increase as the program becomes 
more complex. For this program, we will develop the program in two steps: 

1. Start with the program template and add code to get input. 

2. Add code to compute and display the monogram. 


step 1 
design 


alternative 
design 1 


alternative 
design 2 


Step 1 Development: Getting Input 

The problem states that the program is to input the user's name and display its initials. It 
does not specify how, so in the design stage, we will decide how to do this. Since, at this 
point, we know only one way to input data, that is, using the Scanner class, we will use it 
here. But in which form shall we input three pieces of data? There are two possible design 
alternatives. 

In the first design, we will input them separately: 

String f i r s t N a me, mi d d I e N a me, I a s t N a me; 

Scanner scanner = new Scanner! System, in); 

System, out. pri nt("Fi rst N a me: " ) ; 
firstName = scanner, n e x t ( ); 

System, out. pri nt("Mi ddl e Name: "); 
mi d d I e N a me = scanner. next( ); 

System, out. pri nt("Last N a me: 11 ) ; 

I a s t N a me = scanner, next) ); 

In the second design, we will input them together: 

String f u I I N a me; 

Scanner scanner = new Scannerf System, i n) ; 

scanner. useDel i mi ter(System. getProperty("l i ne. separator")); 

System, out. pri nt("Ful I N a me: " ) ; 
f u I I N a me = scanner. next( ); 


Which design is better?There is never"one correct answer"to the design problems. 
We have to select the one from the possible alternatives that satisfies the different crite¬ 
ria most effectively in a given situation. The criteria may include the user's needs and 
preferences, faster performance, development costs, time contraints, and other factors. 
For example, in one situation, we may decide to forgo some great user interface features 
so the development can be completed under budget. 

In this sample development, we will consider the alternative designs from the 
overall quality of the program's user interface. In other words, we want to make our pro¬ 
gram as user-friendly as possible. We want our users to have a pleasant experience using 
our program.The program should not be cumbersome to use, or else the users will get 
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very frustrated in using the program. Which design would give the better user experi¬ 
ence? In the first approach, the user enters the information separately with three dialogs, 
while in the second approach, the user enters the information together with one dialog. 
We choose the second approach because it allows quicker data entry, and in general, it is 
more natural to treat the name as a single entity than as three separate entitites. If we 
were to enter the name, address, and phone number, then we would use three dialogs as 
they are three separate entities. In this situation, we consider the first, middle, and last 
names as part of a single entity. 

Notice that the decision to enter the full name by using one dialog makes our task 
as the programmer slightly more difficult because we need to extract the first, middle, 
and last names from a single string. In the first approach, as we get the first, middle, and 
last names separately, there's no such need. So, if we consider strictly the ease of develop¬ 
ment, the first approach is better. It is important to remember, however, that we are de¬ 
veloping the program for the sake of the users, not for ourselves. 



hings to Remember 


We develop programs for the sake of users, not for ourselves. Ease of use has higher 
priority than ease of development. 


step 1 code Let's ' m Pl ement the second design alternative. In the code, notice the use of the output 
statement that prints the string entered by the user.This printing of the input is another 
form of echo printing (introduced in Section 2.4.4). By echo printing, we verify that the 
input value is indeed read in correctly. 



Chapter 2 Sample Program: Displays the Monogram 
File: Stepl/Ch2 Mo nogram, java 


/ * 

import java,util.*; 
class C h 2 Mo nogram { 

public static void mai n(Stri ng[] args) { 
String n a me; 

Scanner scanner = new Scanner(System, in); 
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scanner. useDel i mi ter(System. getProperty("l i ne. separator")); 
System, out. print) "Enter your full name (first, middle, last):"); 
name = scanner. next( ); 

System, out. pri ntl n("Name entered: " + name); 

} 

} 


step 1 test After t * ie P r0 9 ram ' s written, we test the program to verify that the program runs as in¬ 
tended. The step 1 program may seem so trivial and not so useful, but it does serve a very 
useful purpose. Successful execution of this program verifies that the program setup is 
okay, the necessary packages are imported, and the objects are declared correctly. Since 
this program is very simple, there's not much testing strategy we can employ other than 
simply running it. For subsequent sample programs, however, the testing strategy will be 
more involved. After the step 1 program is compiled and executed correctly, we move on 
to step 2. 

Step 2 Development: Computing and Displaying the Monogram 

step 2 The next tas ^ ' s t0 extract initials from the input string. First, because of our limited 

design knowledge of programming at this point, we will assume the input is correct. That is, 

the input string contains first, middle, and last names, and they are separated by single 
blank spaces. Second, there are many possible solutions, but we will solve this problem 
by using only the methods covered in this chapter. Reviewing the string methods we 
covered in this chapter and the Ch2String Processing class, we know that a sequence 
of indexOf and substring methods can divide a string (full name) into two substrings 
(first and last names). Flow can we adapt this technique to now divide a string (full 
name) into three substrings (first, middle, and last names)? Aha! We apply the sequence 
one more time, as shown in Figure 2.18. 

Once we divide the input name into first, middle, and last names, extracting the ini¬ 
tials is a fairly straightforward application of the indexOf method. We can extract the first 
letter of a string as 

str. substri ng(0, 1 ) 

And the monogram can be formulated by concatenating three initials as 

first, substri ng(0, 1) 

+ mi ddl e. substri ng(0, 1) 

+ I ast. s ubst r i ng( 0, 1) 
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String name; 

name = "Jon Jay Java"; 


General Idea 


Jon Jay Java 


Jon Jay Java 


Jay Java 


Actual Statements 


Jon Jay Java 



Jon 


Jay Java 



Jay 


Java 


Figure 2.18 Apply the two sequences of indexOf and substring methods to extract three substrings 
from a given string. 

Step 2 code Here's our step 2 code: 



Chapter 2 Sample Program: Displays the Monogram 
File: Step2/Ch2 Mo nogram, java 

*/ 
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import java,util.*; 
class C h 2 Mo nogram { 

public static void main(String[] args) { 

String n a me; 

Scanner scanner = new Scanner(System. in); 
scanner. useDel i mi ter(System. getProperty("l i ne, separator 
System, out. print) “Enter your full name (first, middle, 
name = scanner. next! ) ; 

System, out. pri ntl n("Name entered: " + name); 


} 


} 


To verify the computation is working correctly, we run the program multiple times and 
enter different names. Remember that we are assuming there is no error in input; that is, 
first, middle,and last names are separated by single blank spaces. Since there are two sub¬ 
tasks involved in this step, it is important to test them separately.To verify that the input 
string is divided into three substrings correctly, we place the following temporary test 
output statements. 

System, out. pri ntl n("Fi rst:" + first); 

System, out. pri ntl n (“ Middle:" + middle); 

System, out. pri ntl n (" Last:" + last); 

These statements are not shown in the step 2 program listing, but they are included in the 
actual sample code. 


Summary 


The three basic components of a Java program are comments, import 
statements, and class declarations. 

A Java program must have one class designated as the main class. The 
designated main class must have the main method. 

An object must be declared and created before we can use it. 

To command an object or a class to perform a task, we send a message to it. We 
use the expression calling a method synonymously with sending a message. 

A single name can be used to refer to different objects (of the same class) at 
different times. An object with no reference will be returned to a system. 
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We follow the edit-compile-run cycle to execute programs. 

A source file is compiled into a bytecode file by a Java compiler. 

A Java interpreter (also called a Java Virtual Machine) executes the bytecode. 
The standard classes introduced (mentioned) in this chapter are 


Da t e 

I nput St r earn 
j F r a me 
Pr i nt St r earn 


Scanner 

Si mpI eDa t eFor mat 

St ri ng 

System 


Table 2.2 lists the Java naming convention. 


Table 2.2 Standard naming convention for Java 


Category 

Convention 

Example 

Class 

Use an uppercase letter for the first letter of 

C u s t o me r 


the class names. If the name consists of 

Mai nWi ndow 


multiple words, the first letter of every word 
is capitalized. 

Myl nput Handl er 

Instance 

Use a lowercase letter for the first letter of 

c u s t o me r 


the object names. If the name consists of 

i nput Handl er 


multiple words, the first letter of every word 
(except the first word) is capitalized. 

myFi rstAppIi cati on 

Constant 

(Note: Sample use of a constant will appear 

DEFAULT RATE 


in Chap. 4. We include it here for 

DEG TO RAD 


completeness and easy reference later.) 

Use all uppercase letters. If the constant 
consists of multiple words, the underscore 
characters are used to separate the words. 

cancel" 

Package 

Use all lowercase letters. 

java 
ga me 
fi nance 


Key Concepts 


standard classes 
program diagram 
identifier 

standard naming convention 
new operator 
garbage collection 
comments 


packages 
dot notation 
class declaration 
method declaration 
edit-compile-run cycle 
source file 
bytecode file 
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Review Exercises 

1. Identify all errors in the following program (color highlighting is disabled): 

/* 


Program Exercisel 

Attempting to display a frame window 

II 

i mpo r t s wi ng, J F r a me; 

class Exercise 1 { 

public void Mai n ( ) { 
j F r a me f r a me; 
fra me. setVi si bl e(TRUE) 

} 

} 

2. Identify all errors in the following program (color highlighting is disabled): 

II 


Program Exerci se2 

Attempting to display a frame of size 300 by 200 pixels 

II 

import javax.Swing.*; 
class t wo { 

public static void main method!) { 
my F r a me j F r a me; 
my F r a me = new j F r a me ( ) ; 
myFrame. setSize(300, 200); 
my F r a me, s e t V i s i b I e ( ) ; 

} 

} 

3. Identify all the errors in the following program (color highlighting is disabled): 

/ * 


Program Exerci se3 

Attempting to display the number of characters 
in a given input. 

*/ 

class three { 

public static void ma i n ( ) { 

String input; 

input = Scanner.next( ); 
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4. 

5. 

6 . 

7. 

8 . 

9. 


10 . 

11 . 

12 . 


13. 


14 . 


System, out.print ("Input has " + 

input.length!) + " characters' 1 ); 

} 

} 

Describe the purpose of comments. Name the types of comments available. 
Can you include comment markers inside a comment? 

What is the purpose of the import statement? Does a Java program always 
have to include an import statement? 

Show the syntax for importing one class and all classes in a package. 
Describe the class that must be included in any Java application. 

What is a reserved word? List all the Java reserved words mentioned in this 
chapter. 

Which of the following are invalid Java identifiers? 


a. 

R2D2 

g- 

3CPO 

b. 

Whatchamac allit 

h. 

This is okay. 

c. 

How AboutThis ? 

i. 

thisIsReallyOkay 

d. 

Java 

j- 

DEFAULT_AMT 

e. 

GoodChoice 

k. 

Bad-Choice 

f. 

12345 

1 . 

A12345 


Describe the steps you take to run a Java application and the tools you use in 
each step. What are source tries and bytecode hies? What different types of 
errors are detected at each step? 

Describe the difference between object declaration and object creation. Use 
a state-of-memory diagram to illustrate the difference. 

Show a state-of-memory diagram after each of these statements is executed: 


J F r a me 

wi ndowl; 

Resi dent 

r es1, r es 2; 

wi ndowl 

= new j F r a me () 

r es 1 

= new Resident 

r es 2 

= new Resident 


Show a state-of-memory diagram after each of these statements is executed: 

Person personl, p e r s o n 2; 

personl = new Person!); 
p e r s o n 2 = new Person!); 

p e r s o n 2 = new Person!); 

Which of these identihers violate the naming convention for class names? 


a. 

r2D2 

e. 

CPO 

b. 

whatchamacallit 

f. 

ThisIsReallyOkay 

c. 

Java 

g- 

java 

d. 

GoodName 

h. 

badName 
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15. Which of these identifiers violate the naming convention for object names? 

a. R2D2 e. 3CPO 

b. isthisokay? f. ThisIsReallyOkay 

c. Java g. java 

d. goodName h. anotherbadone 

16. For each of these expressions, determine its result. Assume the value of text 
is a string Java Programming. 




St 

ring t 

ex 

t 


j a v 

a Pr og r a mmi n 

g“ ; 

a. 

t e 

xt 

.s ubst 

r i 

ng 

0 

4) 



b. 

t e 

xt 

.1 engt 

h ( 

) 





c. 

t e 

xt 

.s ubst 

r i 

ng 

8 

12 

) 


d. 

t e 

xt 

.s ubst 

r i 

ng 

0 

1) 

+ t ext. s ubs 

t r i ng( 7, 9) 

e. 

t e 

xt 

.s ubst 

r i 

ng 

5 

6) 






+ 

t e 

xt 

s 

jbst 

ri ng ( t ext. 1 e 

ngt h() - 3, text 


Level 1 Programming Exercises ★ 

17. Write a program that displays a frame window 800 pixels wide and 600 pixels 
high. Set the title of the frame to Welcome to Java. 

18. Input the user’s first and last name as two separate strings. Then display a 
frame window with its title set to <last>, <first>, where <last> and <first> are 
the input values. For example, if the input values are Johann and Strauss, 
then the title would be Strauss, Johann. 

19. Input the user’s first, middle, and last name as three separate strings and 
display the name in the order of the first name, the middle initial, and the last 
name. Include the period after the middle initial. If the input strings are 
Wolfgang, Amadeus, and Mozart, for example, then the ouput would be 
Wolfgang A. Mozart. Use the console window for output. 

20. Write a program to display today’s date in this format: 10 December 2008. 
Use the console window for output. Refer to Table 2.1 for the necessary 
designator symbols. 

21. Repeat Exercise 20, but this time use this format: Monday December 10, 
2008. 


Level 2 Programming Exercises ★★ 

22. Write a program that displays a frame window W pixels wide and H pixels 
high. Use the Scanner to enter the values for W and H. The title of the frame 
is also entered by the user. 

23. Display the current time in the title of a frame window using this format: 
12:45:43 PM. Refer to Table 2.1 for the necessary designator symbols. 
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24. Write a Java program that displays a frame window 300 pixels wide and 
200 pixels high with the title My First Frame. Place the frame so that its top 
left corner is at a position 50 pixels from the top of the screen and 100 pixels 
from the left of the screen. To position a window at a specified location, you 
use the setLocation method, as in 

//assume ma i n Wi n d o w is declared and created 

frame, set Locati on( 5 0, 5 0 ) ; 

Through experimentation, determine how the two arguments in the 
setLocation method affect the positioning of the window. 

25. Because today’s computers are very fast, you will probably not notice any 
discernible difference on the screen between the code 

J F r a me my Wi nd o w; 

my Wi n d o w = new J F r a me ( ); 

myWi ndow. setVi si bl e( true ); 

and 

j F r a me my Wi ndow; 
my Wi ndow = new J F r a me ( ); 
myWi ndow. setVi si bl e( true ); 
myWi ndow. setVi si bl e( false ); 
myWi ndow. setVi si bl e( true ); 

One way to see the disappearance and reappearance of the window is to put 
a delay between the successive setVisible messages. Here’s the magic code 
that puts a delay of 0.5 s: 

try {Thread. si eep(500); } catch( Exception e) { } 

The argument we pass to the sleep method specifies the amount of delay in 
milliseconds [note: 1000 milliseconds (ms) = 1 second (s)]. We will not 
explain this magic code. 

26. Using the Scanner, input a string that contains a single exclamation mark. 
Divide the input string into two strings, one before and the other after the 
exclamation mark, and output them. Do not include the exclamation mark in 
the output. For example, if the input string is one potato two potato Ithree, 
then the output would be 

one potato two potato 
three 

Level 3 Programming Exercises ★★★ 

27. Write a program that accepts a string input and outputs the number of 
characters in the string and the first and last character in separate lines. For 
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example, if the input is I like Java then the output would be 

11 

I 

a 

28. Write a program that accepts a word and prints out the middle character. 

The length of the input word is odd. For example, if the input is magnificent, 
which has 11 characters, you output the sixth character f. You use the 
division operator /. This operator returns only the quotient. For example, the 
expression 10/4 would result in 2 (not 2.5). 

29. At the McGraw-Flill book website, you will find a Java package called 
galapagos. The galapagos package includes a Turtle class that is modeled 
after Seymour Papert’s logo. This Turtle has a pen, and when you move the 
Turtle, its pen will trace the movement. So by moving a Turtle object, you 
can draw many different kinds of geometric shapes. For example, this 
program commands a Turtle to draw a square: 


import galapagos.*; 

class Square { 





public static vo 

id ma i n ( 

St r i 

ng 

] arg ) { 

Turtle turtle 
turtle = new 

Turt1 e ( 

); 



t u r 11 e, move) 

50 ); II 

move 

50 

pixels 

turtle, turn( 

90 ); II 

turn 

90 

deg counterclockwise 

t u r 11 e, move( 

50 ); 




turtle, turn( 

90 ); 




t u r 11 e, move) 

50 ); 




turtle, turn( 

90 ); 




t u r 11 e, move) 

50 ); 





} 

} 


Write a program to draw a triangle. Read the documentation and see 
if you can find a way to draw the square in a different color and line 
thickness. 

30. Using the Turtle introduced in Exercise 29, draw a star. 

31. Using the Turtle introduced in Exercise 29, draw a big letter J. You can draw 
a big J by drawing one horizontal line, one vertical line, and one semi-circle 
as follows: 
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32. Using the Turtle introduced in Exercise 29, draw three nested rectangles. 


33. Using the Turtle introduced in Exercise 29, display the text Hello five times 
at the approximate positions shown below: 



Hello Hello 


Hello 


Hello Hello 


Development Exercises 

34. Follow the incremental development methodology explained in this chapter 
to implement a program for the following problem statement. You must 
clearly write down the program tasks, create a design document with class 
descriptions, and draw the program diagram. Identify the development steps. 
State any assumptions you must make about the input. Articulate any design 
alternatives, and justify your selection. Be sure to perform adequate testing 
at the end of each development step. 

Problem Statement: Write a program that asks the user for his or her birth 
date and replies with the day of the week on which he or she was born. 

We learned in this chapter that we can create a Date object for today’s date 
by writing 

import java,util.*; 

Dat e today = new D a t e () ; 

To create a Date object for a date other than today, we can use the Date class 
from the java.sql package. (A more general and flexible way to deal with a 
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date by using the GregorianCalendar class is introduced in Chap. 3.) 

Notice that there are two distinct classes with the same name Date, but 
from different packages—one from java.util and another from java.sql. 

To distinguish the two, we will use the fully qualified names. To create 
a new java.util.Date object, we can call the class method valueOf of the 
java.sql.Date class with the string representation of a date. The string 
representation must be in the format yyyy-MM-dd. For example, to create 
a java.util.Date object for July 4, 1776, we write 

java.util. Date bdate = java.sql. Date, value Of (" 1776-07-04 "); 

Notice that valueOf is a class method of the Date class in the java.sql 
package. Calling it with a correct argument will return a java.util.Date object 
for the specified date. 

35. Repeat Exercise 34 for this problem statement: 

Problem Statement: Write a program that asks the user for her or his 
full name in the format 

first middle last 

and replies with the name in the format 

last, first middle-initial. 

where the last name is followed by comma and the middle initial is followed 
by period. 

For example, if the input is 
Decafe Chai Latte 
then the output is 

Latte, Decafe C. 

36. Repeat Exercise 34 for this problem statement: 

Problem Statement: Using the Turtle from Exercise 29, write a program that 
draws a house. 
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Objectives 


After you have read and studied this chapter,you 
should be able to 

• Select proper types for numerical data. 

• Write arithmetic expressions in Java. 

• Evaluate arithmetic expressions,following the 
precedence rules. 

• Describe how the memory allocation works for 
objects and primitive data values. 

• Write mathematical expressions, using 
methods in the Math class. 

• Use the GregorianCalendar class in 
manipulating date information such as year, 
month, and day. 

• Use the DecimalFormat class to format 
numerical data. 

• Convert input string values to numerical data. 

• Input numerical data by using System.in and 
output numerical data by using System.out. 

• Apply the incremental development technique 
in writing programs. 

• (Optional ) Describe how the integers and real 
numbers are represented in memory. 
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Saw 

hen we review the Ch2Monogram sample program, we can visualize three tasks: 
input, computation, and output. We view computer programs as getting input, per¬ 
forming computation on the input data, and outputting the results of the computa¬ 
tions. The type of computation we performed in Chapter 2 is string processing. In 
this chapter, we will study another type of computation, the one that deals with 
numerical data. Consider, for example, a metric converter program that accepts 
measurements in U.S. units (input), converts the measurements (computation), and 
displays their metric equivalents (output). The three tasks are not limited to numer¬ 
ical or string values, though. An input could be a mouse movement. A drawing pro¬ 
gram may accept mouse dragging (input), remember the points of mouse positions 
(computation), and draw lines connecting the points (output). Selecting a menu item 
is yet another form of input. For beginners, however, it is easiest to start writing 
programs that accept numerical or string values as input and display the result of 
computation as output. 

We will introduce more standard classes to reinforce the object-oriented style 
of programming. The Math class includes methods we can use to express mathe¬ 
matical formulas. The DecimalFormat class includes a method to format numerical 
data so we can display the data in a desired precision. The GregorianCalendar class 
includes methods to manipulate the date. The Random class includes methods to 
generate different types of random numbers. In Chapter 2, we performed String 
input and output by using the standard input (Scanner) and output (System.out). We 
will describe the input and output routines for numerical data in this chapter. 

Finally, we will continue to employ the incremental development technique 
introduced in Chapter 2 in developing the sample application, a loan calculator pro¬ 
gram. As the sample program gets more complex, well-planned development steps 
will smooth the development effort. 


3.1 


Variables 


Suppose we want to compute the sum and difference of two numbers. Let’s call the 
two numbers x and y. In mathematics, we say 


x + y 
and 


x - y 

To compute the sum and the difference of x and y in a Java program, we must first 
declare what kind of data will be assigned to them. After we assign values to them, 
we can compute their sum and difference. 

Let’s say x and y are integers. To declare that the type of data assigned to them 
is an integer, we write 

i n t x, y; 
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When this declaration is made, memory locations to store data values for x and y are 
variable allocated. These memory locations are called variables, and x and y are the names 

we associate with the memory locations. Any valid identifier can be used as a vari¬ 
able name. After the declaration is made, we can assign only integers to x and y. We 
cannot, for example, assign real numbers to them. 



hings to Remember 


A variable has three properties: a memory location to store the value, the type of 
data stored in the memory location, and the name used to refer to the memory 
location. 


Although we must say “x and y are variable names” to be precise, we will use the 
abbreviated form “x and y are variables” or “x and y are integer variables” whenever 
appropriate. 

The general syntax for declaring variables is 

variable <d a t a t y p e > <vari abl es> ; 

declaration 

s yntax where <variables> is a sequence of identifiers separated by commas. Every variable 

we use in a program must be declared. We may have as many declarations as we 
wish. For example, we can declare x and y separately as 

i nt x; 

i nt y; 


However, we cannot declare the same variable more than once; therefore, the sec¬ 
ond declaration below is invalid because y is declared twice: 


six numerical 
data types 


higher 

precision 


i nt x , y , z ; 

i nt y ; 

There are six numerical data types in Java: byte, short, int, long, float, and 
double. The data types byte, short, int, and long are for integers; and the data types 
float and double are for real numbers. The data type names byte, short, and others 
are all reserved words. The difference among these six numerical data types is in 
the range of values they can represent, as shown in Table 3.1. 

A data type with a larger range of values is said to have a higher precision. For 
example, the data type double has a higher precision than the data type float. The 
tradeoff for higher precision is memory space—to store a number with higher pre¬ 
cision, you need more space. A variable of type short requires 2 bytes and a variable 
of type int requires 4 bytes, for example. If your program does not use many 
integers, then whether you declare them as short or int is really not that critical. The 
difference in memory usage is very small and not a deciding factor in the program 
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Table 3.1 Java numerical data types and their precisions 


Data 

Type 

Content 

Default 

Value* 

Minimum Value 

Maximum Value 

byte 

Integer 

0 

-128 

127 

short 

Integer 

0 

-32768 

32767 

i nt 

Integer 

0 

-2147483648 

2147483647 

long 

Integer 

0 

-9223372036854775808 

9223372036854775807 

float 

Real 

0.0 

-3.40282347E+38* 

3.40282347E+38 

d o u b 1 e 

Real 

0.0 

-1.79769313486231570E+308 

1.79769313486231570E+308 


' No default value is assigned to a local variable. A local variable is explained on page 191 in Section 4.8. 

* The character E indicates a number is expressed in scientific notation. This notation is explained on page 100. 


design. The storage difference becomes significant only when your program uses 
thousands of integers. Therefore, we will almost always use the data type int for in¬ 
tegers. We use long when we need to process very large integers that are outside the 
range of values int can represent. For real numbers, it is more common to use dou¬ 
ble. Although it requires more memory space than float, we prefer double because 
of its higher precision in representing real numbers. We will describe how the num¬ 
bers are stored in memory in Section 3.10. 


Qjpu 

D Might 
Want to 

Know 


Application programs we develop in this book are intended for computers with 
a large amount of memory (such as desktops or laptops), so the storage space is 
not normally a major concern because we have more than enough. However, 
when we develop applications for embedded or specialized devices with a very 
limited amount of memory, such as PDAs, cellular phones, mobile robots for 
Mars exploration, and others, reducing the memory usage becomes a major 
concern. 


Flere is an example of declaring variables of different data types: 

int i , j , k; 

float numberOne, numberTwo; 

long bi gl nteger; 

double b i g N u mb e r; 

At the time a variable is declared, it also can be initialized. For example, we may 
initialize the integer variables count and height to 10 and 34 as in 

int count = 10, height = 34; 
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Hints, 

HM 

Pitfalls 



As we mentioned in Chapter 2, you can declare and create an object just as you 
can initialize variables at the time you declare them. For example, the declaration 

Date today = new D a t e(); 

is equivalent to 

Dat e today; 
today = new Dat e( ) ; 


assignment 

statement 


assignment 

statement 

syntax 


We assign a value to a variable by using an assignment statement. To assign 
the value 234 to the variable named firstNumber, for example, we write 

f i r st Number = 2 3 4; 

Be careful not to confuse mathematical equality and assignment. For example, the 
following are not valid Java code: 

4 + 5 p| 

x + y = y + x; 

The syntax for the assignment statement is 
<v a ria bI e > = <expression> ; 

where <expression> is an arithmetic expression, and the value of <expression> is 
assigned to the <variable>. The following are sample assignment statements: 

sum = firstNumber + secondNumber; 

solution = x*x - 2*x+l; 
average =(x +y +z) / 3.0; 

We will present a detailed discussion of arithmetic expressions in Section 3.2. One 
key point we need to remember about variables is the following: 


Liftings to Remember 

Before using a variable, we must first declare and assign a value to it. 



The diagram in Figure 3.1 illustrates the effect of variable declaration and as¬ 
signment. Notice the similarity with this and memory allocation for object declara¬ 
tion and creation, illustrated in Figure 2.4 on page 36. Figure 3.2 compares the two. 
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i nt firstNumber, secondNumber; 


firstNumber = 234; 
secondNumber = 87; 


State of Memory 

after (a) is executed 


firstNumber 

secondNumber 


The variables firstNumber and secondNumber 
are declared and set in memory. 



i nt firstNumber, secondNumber; after ( B ) is executed 


firstNumber 

= 234; 

firstNumber 

234 

secondNumber 

= 87; 





secondNumber 

87 


Values are assigned to the variables firstNumber 
and secondNumber. 

V___ J 


Figure 3.1 A diagram showing how two memory locations (variables) with names firstNumber and 
secondNumber are declared, and values are assigned to them. 

What we have been calling object names are really variables. The only difference 
between a variable for numbers and a variable for objects is the contents in the mem¬ 
ory locations. For numbers, a variable contains the numerical value itself; and for 
objects, a variable contains an address where the object is stored. We use an arrow 
in the diagram to indicate that the content is an address, not the value itself. 



hings to Remember 


Object names are synonymous with variables whose contents are references to 
objects (i.e., memory addresses). 


Figure 3.3 contrasts the effect of assigning the content of one variable to an¬ 
other variable for numerical data values and for objects. Because the content of a 
variable for objects is an address, assigning the content of a variable to another 
makes two variables that refer to the same object. Assignment does not create a new 
object. Without executing the new command, no new object is created. We can view 
the situation in which two variables refer to the same object as the object having two 
distinct names. 
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Numerical Data 


Object 


i nt number; 

number = 237; 
number = 35; 


Customer customer; 

customer = new Customer( ) ; 
customer = new Customer() ; 


number 


customer 


i nt number; 


number = 237; 


number = 35; customer = new Customer( ) ; 


Customer customer; 
customer = new Customer() ; 


number 



i nt number; 
number = 237; 
number = 35; 


Customer customer; 
customer = new Customer( ) ; 
customer = new Customer( ) ; 


number 


35 



Figure 3.2 A difference between object declaration and numerical data declaration. 


For numbers, the amount of memory space required is fixed. The values for 
data type int require 4 bytes, for example, and this won’t change. However, with ob¬ 
jects, the amount of memory space required is not constant. One instance of the 
Account class may require 120 bytes, while another instance of the same class may 
require 140 bytes. The difference in space usage for the account objects would 
occur if we had to keep track of checks written against the accounts. If one account 
has 15 checks written and the second account has 25 checks written, then we need 
more memory space for the second account than for the first account. 

We use the new command to actually create an object. Remember that declar¬ 
ing an object only allocates the variable whose content will be an address. On the 
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Numerical Data 


Object 


i lit number1, number2; 

number1 = 237; 
number2 = number1; 


Professor alan, turing; 

alan = new Professor!) ; 
turing = alan; 


number 1 
number2 



alan 




turing 



i nt number1, number2; 


numberl = 237; 


number2 = numberl; 


Professor alan, turing; 
alan = new Professor!) ; 


turing = alan; 



i nt numberl, number2; Professor alan, turing; 

alan = new Professor!) ; 

turing = alan; 


numberl = 237; 


number2 = numberl; 



Figure 3.3 An effect of assigning the content of one variable to another. 


other hand, we don’t “create” an integer because the space to store the value is 
reference already allocated at the time the integer variable is declared. Because the contents 

versus are addresses that refer to memory locations where the objects are actually stored, 

primitive data objects are called reference data fy . In contrast, numerical data types are called 
types primitive data types. 
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In addition to the six numerical data types, there are two nonnumerical primitive 
data types.The data type boolean is used to represent two logical values true and 
false. For example, the statements 

boolean raining; 
raining = true; 

assign the value true to a boolean variable raining. We will explain and start using 
boolean variables beginning in Chapter 5. The second nonnumerical primitive 
data type is char (for character). It is used to represent a single character (letter, 
digit, punctuation marks, and others). The following example assigns the upper¬ 
case letter A to a char variable letter: 

char letter; 
letter = 'A'; 

A char constant is designated by single quotes. We will study the char data type in 
Chapter 9 on string processing. 


r— 

Quick 

CHECK 


1. Why are the following declarations all invalid (color highlighting is disabled)? 

i nt a, b, a; 

float x, i nt; 

float w, i nt x; 

blgNumber double; 

2. Assuming the following declarations are executed in sequence, why are the 
second and third declarations invalid? 

i nt a, b; 

i nt a; 

float b; 

3. Name six data types for numerical values. 

4. Which of the following are valid assignment statements (assuming the 
variables are properly declared)? 

x =12; 

12 = x; 

y + y = x; 

y = x + 12; 

5. Draw the state-of-memory diagram for the following code. 

Account latteAcct, espressoAcct; 

latte Acct = new Account!); 
espressoAcct = new Account!); 
latteAcct = espressoAcct; 
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3.2 


Arithmetic Expressions 


An expression involving numerical values such as 


23 + 45 


is called an arithmetic expression, because it consists of arithmetic operators and 
arithmetic operands. An arithmetic operator, such as + in the example, designates numerical 

operator computation. Table 3.2 summarizes the arithmetic operators available in Java. 

Notice how the division operator works in Java. When both numbers are inte¬ 
gers, the result is an integer quotient. That is, any fractional part is truncated. Divi- 
integerdivision sion between two integers is called integer division. When either or both numbers 
are float or double, the result is a real number. Here are some division examples: 



The modulo operator returns the remainder of a division. Although real num¬ 
bers can be used with the modulo operator, the most common use of the modulo 
operator involves only integers. Here are some examples: 



Table 3.2 Arithmetic operators 


Operation 

Java 

Operator 

Example 

Value 

(x= 10,y = 7,z = 2.5) 

Addition 

+ 

x + y 

17 

Subtraction 

- 

x - y 

3 

Multiplication 

* 

x * y 

70 

Division 

/ 

x / y 

1 



x / z 

4. 0 

Modulo division 

% 

x % y 

3 

(remainder) 
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operand 


binary operator 


subexpression 


precedence 

rules 


The expression 23 % 5 results in 3 because 23 divided by 5 is 4 with remainder 3. 
Notice that x % y = 0 when y divides x perfectly; for example, 16 % 2 = 0. Also notice 
that x % y = x when y is larger than x; for example, 23 % 25 = 23. 

An operand in arithmetic expressions can be a constant, a variable, a method 
call, or another arithmetic expression, possibly surrounded by parentheses. Let’s 
look at examples. In the expression 

x + 4 

we have one addition operator and two operands—a variable x and a constant 4. 
The addition operator is called a binary operator because it operates on two operands. 
All other arithmetic operators except the minus are also binary. The minus and 
plus operators can be both binary and unary. A unary operator operates on one 
operand as in 

- x 

In the expression 
x + 3 * y 

the addition operator acts on operands x and 3 * y. The right operand for the addition 
operator is itself an expression. Often a nested expression is called a subexpression. 
The subexpression 3 * y has operands 3 and y. The following diagram illustrates this 
relationship: 



When two or more operators are present in an expression, we determine 
the order of evaluation by following the precedence rules. For example, multi¬ 
plication has a higher precedence than addition. Therefore, in the expression 
x + 3 * y, the multiplication operation is evaluated first, and the addition operation 
is evaluated next. Table 3.3 summarizes the precedence rules for arithmetic 
operators. 
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Table 3.3 Precedence rules for arithmetic operators and parentheses 


Order 

Group 

Operator 

Rule 

Hi gh 

Subexpressi on 

( ) 

Subexpressions are evaluated first. If 





parentheses are nested, the innermost 
subexpression is evaluated first. If two or 
more pairs of parentheses are on the same 
level, then they are evaluated from left to 
right. 



Unary operator 

- , + 

Unary minuses and pluses are evaluated 
second. 



Mu 1ti p1i cati ve 

*, 1 , % 

Multiplicative operators are evaluated 



operator 


third. If two or more multiplicative 
operators are in an expression, then they 
are evaluated from left to right. 

Low 

Additi ve operator 

+ , - 

Additive operators are evaluated last. If 





two or more additive operators are in an 
expression, then they are evaluated from 
left to right. 


The following example illustrates the precedence rules applied to a complex 
arithmetic expression: 


a * (b +-(c / d) / e) * (f - g %h) 



When an arithmetic expression consists of variables and constants of the same 
data type, then the result of the expression will be that data type also. For example, 
if the data type of a and b is int, then the result of the expression 

a * b + 2 3 


implicit and 
explicit type 
casting 


is also an int. When the data types of variables and constants in an arithmetic ex¬ 
pression are different data types, then a casting conversion will take place. A casting 
conversion, or typecasting, is a process that converts a value of one data type to an¬ 
other data type. Two types of casting conversions in Java are implicit and explicit. 
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Operator Type Promotion Rule 


Binary 


Unary 


converted to i n t. 

2. Otherwise, the operand remains the same type. 


1. If the operand is of type byte or s h o r t ,then it is 


1. If either operand is of type d o u b I e,then the other operand 
is converted to d o u b I e . 


2. Otherwise, if either operand is of type f I o a t ,then the other 
operand is converted to f I oat. 


3. Otherwise, if either operand is of type long, then the other 
operand is converted to I o n g . 


4. Otherwise, both operands are converted to i nt . 


numeric 

promotion 


typecast 

operator 


typecasting 

syntax 


An implicit conversion called numeric promotion is applied to the operands of an 
arithmetic operator. The promotion is based on the rules stated in Table 3.4. This 
conversion is called promotion because the operand is converted from a lower to a 
higher precision. 

Instead of relying on implicit conversion, we can use explicit conversion to 
convert an operand from one data type to another. Explicit conversion is applied to 
an operand by using a typecast operator. For example, to convert the int variable x 
in the expression 


to float so the result will not be truncated, we apply the typecast operator (float) as 
(float) x / 3 

The syntax is 

( < d a t a t y p e > ) <expression> 

The typecast operator is a unary operator and has a precedence higher than that of 
any binary operator. You must use parentheses to typecast a subexpression; for ex¬ 
ample, the expression 

a + ( double) ( x + y * z) 

will result in the subexpression x + y * z typecast to double. 

Assuming the variable x is an int, then the assignment statement 

x = 2 * ( 1 4 3 4 3 / 2 3 4 4 ) ; 

will assign the integer result of the expression to the variable x. However, if the 
data type of x is other than int, then an implicit conversion will occur so that the 


numeric 

promotion 


typecast 

operator 


typecasting 

syntax 
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assignment 

conversion 


shorthand 

assignment 

operator 


data type of the expression becomes the same as the data type of the variable. An 
assignment conversion is another implicit conversion that occurs when the vari¬ 
able and the value of an expression in an assignment statement are not of the 
same data type. An assignment conversion occurs only if the data type of the 
variable has a higher precision than the data type of the expression’s value. For 
example, 

double number; 
number = 25; 

is valid, but 

i nt n umbe r; 

number = 2 3 4.5 6; — invalid 

is not. 

In writing programs, we often have to increment or decrement the value of a 
variable by a certain amount. For example, to increase the value of sum by 5, we 
write 


sum = sum + 5; 

We can rewrite this statement without repeating the same variable on the left- and 
right-hand sides of the assignment symbol by using the shorthand assignment 
operator: 

sum += 5; 

Table 3.5 lists five shorthand assignment operators available in Java. 

These shorthand assignment operators have precedence lower than that of any 
other arithmetic operators; so, for example, the statement 

s u m * = a + b; 

is equivalent to 

sum = sum* (a +b); 


Table 3.5 Shorthand assignment operators 


Operator 

Usage 

Meaning 

+= 

a += b; 

a = a + b; 

- = 

a —= b; 

a = a - b; 

*_ 

a *= b; 

a = a * b; 

/= 

a /= b; 

a = a / b; 

%= 

a %= b; 

a = a % b; 
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Hints, 

Pitfalls 



If we wish to assign a value to multiple variables, we can cascade the assignment 
operations as 

x = y = 1; 

which is equivalent to saying 


The assignment symbol = is actually an operator, and its precedence order is 
lower than that of any other operators. Assignment operators are evaluated 
right to left. 


F— 

Quick 

CHECK 

V 


1. Evaluate the following expressions. 

a 3 + 5 / 7 

b. 3 * 3 + 3 % 2 

c. 3 + 2 / 5 + - 2 * 4 

d 2 * ( 1 + - ( 3/ 4) / 2) * ( 2 - 6 % 3) 

2. What is the data type of the result of the following expressions? 

a (3 + 5) / 7 

b. ( 3 + 5) / (float) 7 

c. ( f I oat ) ( ( 3 + 5) II) 

3. Which of the following expressions is equivalent to —b{c + 34)/(2 a)l 

a - b * ( c + 34) / 2 * a 

b. - b * ( c + 34) / ( 2 * a) 

c. - b * c +34 / ( 2 * a ) 

4. Rewrite the following statements without using the shorthand operators. 

a x += y; 

b. x *= v + w; 

c. x / = y; 


constant 


3.3 


Constants 


While a program is running, different values may be assigned to a variable at dif¬ 
ferent times (thus the name variable, since the values it contains can vary), but in 
some cases we do not want this to happen. In other words, we want to “lock” the 
assigned value so that no changes can take place. If we want a value to remain fixed, 
then we use a constant. A constant is declared in a manner similar to a variable but 
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with the additional reserved word final. A constant must be assigned a value at the 
time of its declaration. Here’s an example of declaring four constants: 


final double 
final short 
final double 
final i nt 


PI =3.14159; 

FARADAY CONSTANT = 23060; // unit is cal/volt 
CM PER T NCH = 2.54; 

MONTHS" I N YEAR = 12; 


named 

constant 

literal constant 


We follow the standard Java convention to name a constant, using only capi¬ 
tal letters and underscores. Judicious use of constants makes programs more read¬ 
able. You will be seeing many uses of constants later in the book, beginning with the 
sample program in this chapter. 

The constant PI is called a named constant or symbolic constant. We refer to 
symbolic constants with identifiers such as PI and FARADAY_CONSTANT. The sec¬ 
ond type of constant is called a literal constant, and we refer to it by using an actual 
value. For example, the following statements contain three literal constants: 


final double PI =3.14159 
double area; 

area = 2 * PI *345.79; 


Literal constants 


When we use the literal constant 2, the data type of the constant is set to inf by 
default. Then how can we specify a literal constant of type long? 1 We append the 
constant with an I (a lowercase letter L) or L as in 

2 L * PI * 3 4 5.7 9 

How about the literal constant 345.79? Since the literal constant contains a 
decimal point, its data type can be only float or double. But which one? The answer 
is double. If a literal constant contains a decimal point, then it is of type double by 
default. To designate a literal constant of type float, we must append the letter f or 
F. For example, 

2 * PI * 345. 79F 

To represent a double literal constant, we may optionally append a d or D. So 
the following two constants are equivalent: 

2* PI * 345.79 is equivalent to 2 * PI * 345.79D 

We also can express float and double literal constants in scientific notation as 

Number X io ex P onent 


1 In most cases, it is not significant to distinguish the two because of automatic type conversion; see Section 3.2. 
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exponential 
notation in 
Java 


Hints, 

Pitfalls 



which in Java is expressed as 

<number > E <exponent > 


Since a numerical constant such as 345.79 represents a double value, these 
statements 

float number; 
number = 345. 79; 

for example, would result in a compilation error. The data types do not match, 
and the variable (float) has lower precision than that of the constant (double). 
To correct this error, we have to write the assignment statement as 

number = 3 4 5. 7 9 f; 

or 

number = (float) 345.79; 

This is one of the common errors that people make in writing Java programs, es¬ 
pecially those with prior programming experience. 


where <number> is a literal constant that may or may not contain a decimal point 
and <exponent> is a signed or an unsigned integer. Lowercase e may be substituted 
for the exponent symbol E. The whole expression may be suffixed by f, F, d, or D. 
The <number> itself cannot be suffixed with symbols f, F, d, or D. Here are some 
examples: 

12.40e+209 
2 3 E 3 3 

2 9.0 0 9 8 e-102 
2 3 4 e +5 D 
4. 45e2 


Here are some additional examples of constant declarations: 

final double S P E E D_ OF _ LI GHT = 3.0E+10D; // unit is c m/ s 
final short MAX_WGT’ALLOWED = 400; 


3.4 


Displaying Numerical Values 


In Chapter 2, we learned how to output string values to the console window 
by using System.out. We can easily output numerical values to the console window 
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as well. We will use the same print and println methods to output numerical values. 
Here’s a simple example that outputs the values of a constant and a variable: 


i nt n um = 15; 


p r i 

nt 

num) ; 

II pri 

nt 

a 

va ri a b1 e 

p r i 

nt 

■ 11 ); 

II pri 

nt 

a 

blank space 

p r i 

nt 

10); 

II pri 

nt 

a 

constant 


Executing the code will result in the following console window: 


Console 

Window 


15 10 


We can use the 
Executing 


println method to skip a line after printing out the value. 


i nt n um = 15; 

System, out. pri ntl n(num); 
System, out, pri ntl n ( 10 ); 


will result in 


Console 

Window 


15 

10 


By using the concatenation operation, it is possible to output multiple values 
with a single print or println method. For example, the statement 


System. 

out. 

p r i 

n t 

30 + " 

" +40 

is equivalent to 






System. 

o u t 

P r i 

nt 

30); 


System. 

o u t 

p r i 

nt 

■ "); 


System. 

o u t 

p r i 

nt 

40) ; 



Notice that the expression 
30 + " " +40 

mixes numerical values and a string. We learned in Chapter 2 that the plus symbol 
is used to concatenate strings, for example, 

"Benjamin" + 11 " + "Franklin" 
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operator 

overloading 



Chap 

File 

*/ 


And, in this chapter, we learned the same plus symbol is used to add numerical 
values, for example, 

4 + 36 


The plus symbol, therefore, could mean two different things: string concatenation 
or numerical addition. When a symbol is used to represent more than one operation, 
this is called operator overloading. 

What happens when the plus symbol appears in a mixed expression? When the 
Java compiler encounters an overloaded operator, the compiler determines the mean¬ 
ing of a symbol by its context. If the left operand and the right operand of the plus 
symbol are both numerical values, then the compiler will treat the symbol as addition; 
otherwise, it will treat the symbol as concatenation. The plus symbol operator is eval¬ 
uated from left to right, and the result of concatenation is a string, so the code 


i nt x = 1; 
i nt y =2; 

String output = "test" + x + y; 

will result in output being set to 
t e s 112 

while the statement 

String output = x + y + "test"; 

will result in output being set to 
31 e s t 

To get the result of test3, we have to write the statement as 



String output = "test" + (x + y); 


so the arithmetic addition is performed first. 

Now let’s look at a small sample program that illustrates a typical use of 
string concatenation in displaying computation results. In this sample program, we 
compute the circumference and the area of a circle with a given radius. The value 
for the radius is assigned in the program (we will discuss how to input this value in 
Section 3.5). Here’s the program: 


er 3 Sample Program: Compute Area and Circumference 
Ch3Ci r cl e, j ava 
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class C h 3 Cir cI e { 

public static void mai n(Stri ng[] args) { 
final double PI = 3.14159; 
double radius, area, circumference; 
radius = 2.35; 


//compute the area and circumference 
area = PI * radius * radius; 

circumference = 2.0 * PI * radius; 

System, out. printing' Given Radius: " + radius); 

System, out. printing Area: " + area); 

System, out.pri ntl n("Ci rcumference: " + circumference); 

} 

} 


When we run this program, we get the following output: 


Console 

Window 


Given Radius: 2.35 
Area: 17.349430775000002 
Circumference: 14.765473 


Notice the precision of decimal places displayed for the results, especially the one 
for the circumference. Although we desire such a high level of precision provided 
by double values during the computation, we may not when displaying the result. 
We can restrict the number of decimal places to display by using the DecimalFormat 
class from the java.text package. 

Although the full use of the DecimalFormat class can be fairly complicated, 
it is very straightforward if all we want is to limit the number of decimal places 
to be displayed. To limit the decimal places to three, for example, we create a 
DecimalFormat object as 

DecimalFormat df = new Dec i ma I F o r mat ( " 0. 0 0 0 "); 
and use it to format the number as 

double num = 234.5698709; 

System, out. pri ntl n("Num: " + d f. f o r ma t ( n u m) ) ; 

When we add an instance of the DecimalFormat class named df and change 
the output statement of the Ch3Circle class to 

System, out. pri ntl n(" Given Radius: " + df.format(radius)); 

System, out. printing' Area: " + df.format(area)); 

System, out. pri ntl n( 11 Ci rcumference: " 

+ df.format(ci rcumference)); 
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we produce the following result: 


Console 

Window 


Given Radius: 2.350 
Area: 17.349 
Circumference: 14.765 


new-line 

control 

character 


tab 

control 

character 


The modified class is named Ch3Circle2 (not shown here). 

Instead of using one println method per line of output, it is possible to output 
multiple lines with a single println or print method by embedding a new-line control 
character in the output. We briefly mentioned a control character in Section 2.4.4. A 
control character is for controlling the output, and we use the backslash symbol to 
denote a control character. The new-fine control character is denoted as \n and has the 
effect of pressing the Enter key in the output. For example, the statements 

System, out. println! "Given Radius: " + radius); 

System, out. println! “Area: " + area); 

System, out. println! "Circumference: " + circumference); 

can be written by using only one println statement as 

System, out. println! 11 Given Radius: " + radius + "\n“ + 

"Area: " + a r e a + " \n“ + 

"Ci rcumference: " + c i r c u mf e r e n c e ); 

There is no limit to the number of new-line control characters you can embed, so we 
can easily skip two lines, for example, by putting two new-line control characters as 
follows: 


System, out. pri ntl n("Number 1: " + n u ml + 11 \ n \ n" + 

" N u mb e r 2: " + n u m2); 

Another useful control character is a tab, which is denoted as \t. We can use 
the tab control character to output the labels, and this results in two columns as 
follows: 

System, out. println! "Given Radius: " + "\t" + radius + " \ n" + 

"Area: " + " \ t \ t" + a r e a + " \ n" + 

"Ci rcumference: " + " \ t" + c i r c u mf e r e n c e ); 

Notice there are two tabs before we output the area. You need to experiment with 
the actual number of tabs to get the right output (the actual number of spaces used 
for each tab could be different depending on your Java IDE). The resulting output 
will be 


Console 

Window 


Gi ven Radi us: 
Area: 

Ci rcumference 


2. 35 

17.349430775000002 

14,765473 
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You can also adjust the output format by appending blank spaces in the label. 
For example, you can rewrite the sample statement as 

System, out. pri ntl n("Gi ven Radius: " + " \ t" + radius + "\n" + 

“Area: " + "\t" + a r e a + " \n" + 

"Ci rcumference: " + " \ t" + c i r c u mf e r e n c e ); 

And, as always, the use of symbolic constants will clean up the code: 


final String TAB = "\t" ; 
final String NEWLINE = " \ n “ ; 

System, out. pri ntl n( 

"Given Radius: 11 + TAB + radius + NEWLINE + 

"Area: 11 + TAB + area + NEWLI NE + 

"Circumference: " + TAB + circumference); 

The new program that illustrates the use of both DecimalFormat and control char¬ 

acters is named Ch3Circle3. Here’s the program: 



Chapter 3 Sample Program: Compute Area and Circumference 
File: Ch3Circle3.java 


import java,text.*; 
class Ch3Circle3 { 

public static void main(String[] args) { 

final double PI = 3.14159; 
final String TAB = " \t" ; 
final String NEWLINE = "\n"; 

double radius, area, circumference; 

DecimalFormat df = new Dec i mal For mat (“ 0. 0 0 0 " ) ; 

radius = 2.35; 

//compute the area and circumference 
area =PI * radius * radius; 

circumference = 2.0 * PI * radius; 

//Display the results 
System, out. pri ntl n( 

"Given Radius: " + TAB + df.format(radius) + NEWLINE + 
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“Area: " + TAB + df.format(area) +NEWLINE + 

"Circumference: " + TAB + df.format(circumference)); 

} 

} 


I 


Quick 

CHECK 


■ 


1. What is the purpose of the control characters? 

2. Which control character is used for a new line? 

3. Using one print statement, output the following: 

Hello, wo r I d! 

My favorite Ben Franklin quote: 

An invest me nt in knowledge 
always pays the best interest. 


3.5 


Getting Numerical Input 


We learned how to input string values by using the Scanner class in Chapter 2. We 
study how to input numerical values with the Scanner class in this section. To input 
strings, we use the next method of the Scanner class. For the numerical input values, 
we use an equivalent method that corresponds to the data type of the value we try 
to input. For instance, to input an int value, we use the nextlnt method. Here’s an 
example of inputting a person’s age: 


Scanner scanner = new Scanner! Syst em. in); 
int age; 

System, out, print) "Enter your age: "); 
age = scanner. nextlnt) ); 


In addition to the int data type, we have five input methods that correspond to 
the other numerical data types. The six input methods for the primitive numerical 
data types are listed in Table 3.6. 


Table 3.6 Methods to input six numerical data types 


Method 

Example 

next Byt e( ) 

byte b = scanner, next Byt e( ); 

next Doubl e( ) 

double d = scanner. nextDoub1 e ( ); 

next F1 oat ( ) 

float f = scanner.nextFI oat) ); 

nextlnt) ) 

int i = scanner. nextlnt) ); 

next Long) ) 

long 1 = scanner, next Long) ); 

next S ho r t ( ) 

short s = scanner.nextShort) ); 
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input buffer 


The following example inputs a person’s height in inches (int) and GPA (float): 

Scanner scanner = new Scanner ( System, in); 

int height; 
fI oat gpa; 

System, out. print! “Enter your height in inches: "); 
height = scanner, next I nt( ); 

System, out. print! “Enter your gpa: "); 
gpa = scanner.nextFI oat( ); 


Remember that the default delimiter between the input values is a white space 
(such as the blank space or a tab); it is possible to input more than one value on a 
single line. The following code inputs two integers: 

Scanner scanner = new Scanner(System. in); 

int numl, num2; 

System, out. print! “Enter two integers: "); 

numl = scanner. nextlnt! ); 
num2 = scanner. nextlnt! ); 

System, out. pri nt("numl = " + n u ml + " n u m2 = " + n u m2 ); 


And here’s a sample interaction: 


Space separates the 
two input values. 


Enter two integers: 12 8 T enter] 
numl = 12 and num2 = 87 


Since the new-line character (when we press the Enter key, this new-line char¬ 
acter is entered into the system) is also a white space, we can enter the two integers 
by pressing the Enter key after each number. Here’s a sample: 


Enter two integers: 12 [ enter ) 
87 [enter] 

numl = 12 and num2 = 87 


When we enter data using System.in, they are placed in input buffer. And the 
next available data in the input buffer are processed when one of the input methods 
is called. This means that the actual processing of input data does not necessarily 
correspond to the display timing of the prompts. Let’s look at an example. Consider 
the following code: 

Scanner scanner = new Scanner(System. in); 
int numl, num2, num3; 
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System, out. print! "Enter Number 1: "); 
numl = scanner. nextlnt! ); 

System, out. print! "Enter Number 2: "); 
num2 = scanner. nextlnt! ); 

System, out. print! "Enter Number 3: "); 
num3 = scanner. nextlnt! ); 

System, out. print! “Values entered are " + 

n u ml + " " + n u m2 + " " + n u m3 ) ; 

We expect the majority of users will input three integers, one at a time, as requested 
by the prompts: 


Enter N u mb e r 

1 

10 ( enter") 

Enter N u mb e r 

2 

2 0 ("enter) 

Enter N u mb e r 

3 

3 0 ( ENTER ) 

Values entered 

are 10 20 30 


However, users do not really have to enter the values one at a time. It is possible 
to enter all three values on a single line without waiting for prompts, for example. This 
will result in an awkward display in the console window. Here’s an example: 


Enter Number 1: 1 0, 2 0, 3 0 enter 

Enter Number 2: Enter Number 3: Values entered are 10 20 30 


Although the display is awkward, the input values are assigned to the respec¬ 
tive variables correctly. The three input values are placed in the input buffer, and 
when the second and third nextlnt methods are called, the corresponding values are 
already in the input buffer, so they get assigned to the variables correctly. 

In Section 3.2, we explained the assignment conversion that allows us to 
assign a value to a higher-precision variable (e.g., assigning an int value to a dou¬ 
ble variable). This type of implicit conversion also occurs with the Scanner class. 
For example, the nextDouble method works without a problem as long as the user 
enters a value that is assignable to a double variable. Here’s an example: 

Scanner scanner = new Scanner!System, in); 

double num; 

System, out. print! "Enter a double: "); 

num = scanner.nextDouble! ): 

System, out. print! "You entered " + num); 


Enter a double: 35 { enter j 
You entered 35.0 
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The nextDouble method accepts the value 35 and then converts it to a double data 
type. This method returns a double value, so even if the user enters an integer, you 
cannot assign the input to an int variable. The following code is therefore invalid: 

Scanner scanner = new Scanner(System. in); 

int num; 

System, out. print! "Enter an integer: "); 

num = scanner.nextDouble! ); . Type mismatch 

System, out. print! 11 You entered " + num); 

Now let’s study how we can mix the input of strings and numerical values. We 
begin with an example. Consider inputting a racehorse’s name and age. Here are a 
proposed code and a sample of expected interaction: 

Scanner scanner = new ScannerfSystem. in); 

String horseName; 

int age; 

System, out. print! "Enter the horse name: "); 

horseName = scanner. next! ): 

System, out. print! "Enter the age: "); 

age = scanner. nextlnt! ); 

System, out. printfhorseNa me + " is " + age + “years old," ); 

Enter the horse name: Barbaro ( enter ) 

Enter the age: 3 [enter]; 

Barbaro is 3 years old, 

Everything seems to be working okay. What will happen if the name of a horse has 
more than one word, such as Sea Biscuit? The code will not work because only the 
first word is assigned to the String variable horseName. Remember that the default 
delimiter is the white space, so the blank space after the first word is treated as the 
end of the first input. Here’s the result when you enter Sea Biscuit: 


Enter the horse name: Sea Biscuit [enter] 

Enter the age: java, util, Input Mi smatchExcepti on 

at j ava. utiI.Scanner.t hrowFor! Scanner.j ava: 819) 
at j ava. utiI.Scanner, next! Scanner.j ava: 1431) 
at j ava. utiI.Scanner, nextl nt ( S c a n n e r.j ava: 2040) 


Only the first four lines of error 
messages are shown here. 
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The most reasonable solution here is to change the delimiter to the line sepa¬ 
rator, as described in Section 2.4.4. Here’s how: 

Scanner scanner = new Scanner! Syst em. in); 

scanner, use Deli mi ter(System. get Property! " I i ne. separator")); 

II the rest is the same 


Enter the horse name: Sea Biscuit [ enter ) 
Enter the age: 3 [enter] 

Sea Biscuit is 3 years old. 


For most situations, using the line separator as the delimiter and inputting one 
value per input line are the best approach. We can, however, use any string for the 
delimiter. So, for example, we can delimit the input values with a character such as 
the pound sign (#), provided, of course, that the pound sign does not occur in the 
actual input values. 


hings to Remember 


To input more than one string and primitive numerical data, set the line separator 
as the delimiter and input one value per input line. 



Instead of using the data type specific methods such as nextlnt, nextDouble, 
and others of the Scanner class, we can input a numerical value in a string format 
and convert it to an appropriate data type by ourselves. For example, we can use the 
class method parselnt of the Integer class to convert a string to an int. Here’s a state¬ 
ment that converts "14" to an int value 14: 

int num = Integer. parselnt! "14“); 

So, the statement 

int num = Integer, parsel nt(scanner. next! )); 
is equivalent to 

int num = scanner. nextlnt! ); 

Passing a string that cannot be converted to an int (e.g., "12b") will result in 
an error. The conversion method is not particularly useful or necessary with the 
scanner, but it can be when the input source is different from the scanner. Other 
common conversion methods are parseDouble, parseFloat, and parseLong of the 
Double, Float, and Long classes, respectively. 
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We close this section by presenting a sample program that extends the 
Ch3Circle3 class by accepting the radius of a circle as an input. Here’s the program: 



Chapter 3 Sample Program: Compute Area and Circumference with 

formatting and standard I/O 


File: Ch3Ci rcl e4.j ava 

*/ 

import java,text.*; 
import java.util.*; 

class Ch3Circl e4 { 

public static void main(String[] args) { 

final double PI = 3.14159: 
final String TAB = "\t"; 
final String NEWLINE = " \ n" ; 

double radius, area, circumference: 

Scanner scanner = new Scanner! System, i n) : 

Dec i mal For mat df = new Dec i ma I F or mat ( " 0. 0 0 0 "); 

System, out. p r i n 11 n { " Enter radius: "); 
radius = scanner.next Double! ): 

//compute the area and circumference 
area = PI * radius * radius; 

circumference =2.0* PI* radius; 

//Display the results 
System, out. pri ntl n( 

“Given Radius: " + TAB + df.format(radius) + NEWLINE + 

“Area: " + TAB + df.format(area) + NEWLINE + 

“Circumference: " + TAB + df.format(circumference)); 

} 

} 


Quick 

CHECK 


1. Write a code to input the height of a user in feet (int) and inches (int). 

2. Write a code to input the full name of a person and his or her age. The full 
name of a person includes the first name and the last name. 

3. Write a code that creates a Scanner object and sets its delimiter to the pound sign. 
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3.6 The Math Class 

Using only the arithmetic operators to express numerical computations is very lim¬ 
iting. Many computations require the use of mathematical functions. For example, 
to express the mathematical formula 


1 . 

- sin 
2 




we need the trigonometric sine and square root functions. The Math class in the 
java.lang package contains class methods for commonly used mathematical func¬ 
tions. Table 3.7 is a partial list of class methods available in the Math class. The class 
also has two class constants PI and E for tt and the natural number e, respectively. 
Using the Math class constant and methods, we can express the preceding formula as 

(1.0 / 2.0) * Mat h. si n ( x - Math.PI / Math.sqrt(y) ) 


Table 3.7 Math class methods for commonly used mathematical functions 

Class 

Argument 

Result 



Method 

Type 

Type 

Description 

Example 

a b s ( a ) 

i nt 

1 nt 

Returns the absolute i nt 

abs(10) -> 10 




value of a. 

abs(—5) — > 5 


1 ong 

1 ong 

Returns the absolute 






long value of a, 




float 

float 

Returns the absolute 






float value of a. 




doubl e 

doubl e 

Returns the absolute 






doubl e value of a, 



a c o s ( a ) f 

doubl e 

doubl e 

Returns the arccosine 

acos(-l) 





of a, 

->3.14159 


a s i n ( a ) f 

doubl e 

doubl e 

Returns the arcsine 

asin(1) 





of a. 

-> 1.57079 


a t a n ( a ) f 

doubl e 

doubl e 

Returns the arctangent 

atan(1) 





of a, 

-> 0.785398 


c ei 1 ( a ) 

doubl e 

doubl e 

Returns the smallest 

ceil(5.6) -> 6.0 





whole number greater 

ceil(5.0) -> 5.0 





than or equal to a . 

ceil(—5.6) 






-5.0 


cost a ) f 

doubl e 

doubl e 

Returns the trigonometric 

cos(i7-/2) — > 0.0 





cosine of a . 



exp( a ) 

doubl e 

doubl e 

Returns the natural 

exp(2) 





numbere(2.718...) 

-> 7.389056099 





raised to the power of a , 



www.it-ebooks.info 











114 Chapter 3 Numerical Data 


Table 3.7 Ma t h class methods for commonly used mathematical functions (Continued) 


Class 

Argument 

Result 



Method 

Type 

Type 

Description 

Example 

floor) a ) 

doubl e 

doubl e 

Returns the largest 

floor(5.6) —> 5.0 




whole number less than 

floor(5.0) —> 5.0 




or equal to a. 

floor(-5.6) 





-> -6.0 

log! a ) 

doubl e 

doubl e 

Returns the natural 

log(2.7183) 




logarithm (base e) of a. 

-> 1.0 

ma x ( a, b ) 

i nt 

i nt 

Returns the larger of a 

max(10,20) 




and b, 

20 


long 

long 

Same as above. 



float 

float 

Same as above. 


mi n ( a, b ) 

1 nt 

i nt 

Returns the smaller of a 

min(10,20) 




and b. 

-> 10 


long 

long 

Same as above. 



float 

float 

Same as above. 


po w( a, b) 

doubl e 

doubl e 

Returns the number a 

pow( 2.0,3.0) 




raised to the power of b, 

->8.0 

random! ) 

<n o n e > 

doubl e 

Generates a random 
number greater than or 
equal to 0.0 and 
less than 1.0. 


round! a ) 

float 

i nt 

Returns the i nt value of 

round(5.6) —> 6 




a rounded to the 

round(5.4) —> 5 




nearest whole number. 

round(-5.6) 





-> -6 


doubl e 

long 

Returns the float value of 
a rounded to the 
nearest whole number. 


sin( a ) t 

doubl e 

doubl e 

Returns the 

sin(-n-/2) 




trigonometric sine of a . 

1.0 

sqrt ( a ) 

doubl e 

doubl e 

Returns the square root 
of a . 

sqrt(9.0) —> 3.0 

tan( a ) f 

doubl e 

doubl e 

Returns the trigono¬ 

tan(i7-/4) 




metric tangent of a , 

-> 1.0 

t o Deg r ees 

doubl e 

doubl e 

Converts the given 

toDegrees(T7-/4) 




angle in radians to 
degrees. 

—>45.0 

t o Radi a ns 

doubl e 

doubl e 

Reverse oft oDegr ees. 

toRadians(90.0) 





-> 1.5707963 


+ A11 trigonometric functions are computed in radians. 
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Notice how the class methods and class constants are referred to in the ex¬ 
pression. The syntax is 

<c I ass name> . <me t hod name> ( <arguments> ) 


or 


<class name> . <cI ass constant > 

Let’s conclude this section with a sample program. Today is the final meet of 
the women’s rowing team against the arch rival university before the upcoming 
Division I NCAA championship. The cheerleaders of the rival team hoisted their 
school flag on the other shore of the river to boost their moral. Not to be outdone, 
we want to hoist our school flag, too. To bring the Goddess of Victory to our side, 
we want our pole to be taller than theirs. Since they won’t let us, we can’t find the 
height of their pole by actually measuring it. We can, however, determine the height 
without actually measuring it if we know the distance b to their flagpole. We can use 
the tangent of angle to determine the pole’s height h as follows: 



Unfortunately, there’s no means for us to go across the river to find out the dis¬ 
tance b. After a moment of deep meditation, it hits us that there’s no need to go 
across the river. We can determine the pole’s height by measuring angles from two 
points on this side of the riverbank, as shown below: 
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And the equation to compute the height h is 

I _ d sin a sin /3 

Vsin(a + /?) sin(a — /3) 

Once we have this equation, all that’s left is to put together a Java program. Here’s 
the program: 



Chapter 3 Sample Program: Estimate the Pole Height 


File: Ch3Pol eHei ght.j ava 

*/ 


import java,text.*; 
import java,util.*; 

class Ch3Pol eHei ght { 


public static void mai n ( String!] args ) { 


double height; 
double distance; 
double alpha; 
double beta; 
double alpha Rad; 
double bet a R a d; 


//height of the pole 
//distance between points A and B 
//angle measured at point A 
//angle measured at point B 
//angle alpha In radians 
//angle beta in radians 


Scanner scanner = new Scanner!Syst em. in); 

scanner, useDeli mi ter(System, getProperty("l i ne, separator")); 


II Get three input values 

System, out. print! “Angle alpha (in degrees):"); 
alpha = scanner.next Double!); 

System, out, print! "Angle beta (in degree):"); 
beta = scanner.next Double!); 


System, out. print! "Distance between points A and B (ft):"); 
distance = scanner. nextDoubI e (); 


//compute the height of the tower 

alphaRad = Ma t h. t o Ra d i a n s ( a I p h a ) ; 
betaRad = Math.toRadi a ns ( beta ); 


height = ( distance * Math.si n ( a I phaRad ) * Math. si n ( betaRad ) ) 

/ 

Math, s q r t ( Math.si n ( a I phaRad + betaRad) * 

Math.si n(al phaRad - betaRad) ); 
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Dec i ma I Format df = new Dec i mal For mat ( " 0. 0 0 0 " ); 

System, out. pri ntl n("l nl n Estimating the height of the pole" 

+ ' \ n \ n" 

+ "Angle at point A (deg): " + df.format(alpha) + "\n" 

+ "Angle at point B (deg): " + df.format(beta) + " \ n" 

+ "Distance between A and B (ft): 11 + df. format(di stance) + " \ n 11 

+ " E s t i ma t e d height (ft): 11 + df.format(height)); 

} 

} 



Quick 


CHECK 

V 


1. What’s wrong with the following? 

a y = (1/2) * Math.s q r t ( X ); 

b. y = s q r t ( 3 8. 0 ) ; 

c. y = Math, e x p ( 2, 3); 

dy = math.sqrt( b * b - 4 * a * c ) / ( 2 * a ); 

2. If another programmer writes the following statements, do you suspect any 
misunderstanding on the part of this programmer? What will be the value 
of y ? 

ay = Ma t h.si n ( 360 ) ; 
b. y = Ma t h. c os ( 4 5 ) ; 


3.7 Random Number Generation 

In many computer applications, especially in simulation and games, we need to gen¬ 
erate random numbers. For example, to simulate a roll of dice, we can generate an in¬ 
teger between 1 and 6. In this section, we explain how to generate random numbers 
using the Random class from the java.util package. (Alternatively, we can use the 
random method of the Math class to generate random numbers, but it is more diffi¬ 
cult to use than the Random class). 

For most applications, the random numbers we want to generate are integers. 
To generate random integers, we use the nextlnt method of the Random class. Here’s 
an example: 

import java.util.*; 

Random random = new Random) ); 

int num = random, nextl nt( ); 
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The nextlnt method returns an int value, that is any value between —2147483648 
and 2147483647 (see Table 3.1). To restrict range of possible values, we can use the 
second form of the nextlnt method in which we pass an argument that specifies the 
upper bound of the range. The lower bound is set to 0. To generate a random integer 
between 0 and 10, for example, we write as follows: 

int num = random, nextl nt(ll); 

Notice that the argument we pass is 11, not 10. The argument we pass to the 
method specifies the total number of possible values, starting from 0. So passing 
the value of 11 specifies that we are getting one of the 11 possible values, ranging 
from 0 to 10. 

Often we want the lower bound of the possible range to be other than 0. 
There is no method in the Random class that allows us to specify both the lower 
bound. It is possible, however, to generate any number between min and max 
where min is greater than 0? Suppose, for example, we want a number between 
1 and 6. We can first generate a number between 0 and 5 and then add 1 to the 
result as 


This generates an integer 
between 0 and 5, inclusive. 

int num = random, nextl nt(6) + 1; 

Let’s derive a formula for the general case. To generate a random integer in 
the range of [min, max] where 0 <= min < max, we write 

int num = random, next I nt( max - mi n+1) + min; 

This generates an integer between 
0 and (max-min), inclusive. 


The expression random.nextlnt(max-min+1) returns an integer between 0 and 
(max-min). By adding min to this value, the final result will then be a value between 
0 + min = min and (max — min) + min = max, as desired. 



Want to 
Know 


The nextlnt (and other methods) in the Random class is called a pseudorandom number 
generator because the number is not truly random. When we call the method repeatedly, 
eventually the numbers generated will repeat themselves. Therefore, theoretically the 
generated numbers are not random; but for all practical purposes, they are random 
enough. 
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Let’s write a short program that selects a winner among the party goers of the 
annual spring fraternity dance. The party goers will receive numbers M + 1, M + 2, 
M + 3, and so on, as they enter the house. The starting value M is determined by the 
fraternity president. The last number assigned is M + N if there are N party goers. At 
the end of the party, we run the program that will randomly select the winning num¬ 
ber from the range of M + 1 and M + N. Here’s the program: 



Chapter 3 Sample Program: Select the Winning Number using the Random cl ass 
File: Ch3Sel ectWi nner.j ava 


*/ 


import java,util.*; 
class Ch3Sel ectWi nner { 


public static void mai n(Stri ng[] args) { 


int starti ngNumber; 
int count; 
i nt wi nni ngNumber; 
int ml n, max; 


II the starting number 
II the number of party goers 
II the wi n ne r 

II the range of random numbers to generate 


Random random = new Random)); //random number generator 


Scanner scan = new Scanner) Syst em. in); 

/ / Get t wo Input values 

System, out, print) "Enter the starting number M: 
starti ngNumber = scan.nextlnt (); 


System, out, print) “Enter the number of party goers 
count = scan.nextlnt)); 


II select the winner 

min = starti ngNumber + 1; 

max = starti ngNunber + count; 

wi nni ngNumber = random, nextl nt) max - mi n+1) + min; 

System, out. pri ntl n("\nThe Winning Number is " + wi nni ngNumber); 


} 


} 
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w 

Quick 

CHECK 

v 


1. What are the possible minimum and the maximum numbers assigned to nu m 
by the following statement? 

int num = random, nextl nt(15); 

2. Write a statement that assigns a random number between 1 and 4, inclusive, to 
an integer variable num. 

3. Write a statement that assigns a random number between min and max, 
inclusive, where 0 <= min < max, to an integer variable num. 


3.8 


The GregorianCalendar Class 


In Chapter 2, we introduced the java.util.Date class to represent a specific instant in 
time. Notice that we are using here the more concise expression “the java.util.Date 
class” to refer to a class from a specific package instead of the longer expression 
“the Date class from the java.util package.” This shorter version is our preferred 
way of notation when we need or want to identify the package to which the class 
belongs. 


iThings to Remember 



When we need to identify the specific package to which a class belongs, we will 
commonly use the concise expression with the full path name, such as 
java.util.Date, instead of writing "the Date class from the java.util package." 


In addition to this class, we have a very useful class named java.util.Gregorian¬ 
Calendar in manipulating calendar information such as year, month, and day. We can 
Gregorian- create a new GregorianCalendar object that represents today as 

Calendar 

GregorianCalendar today = new GregorianCalendar! ) ,- 

or a specific day, say, July 4, 1776, by passing year, month, and day as the parame¬ 
ters as 

The value of 6 
means July. 

GregorianCalendar i ndependenceDay = 

new GregorianCaI endar ( 1776, 6, 4); 

No, the value of 6 as the second parameter is not an error. The first month of a 
year, January, is represented by 0, the second month by 1, and so forth. To avoid 
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Tahla A Constants defined in the Ca I endar class for retrieved different pieces of 
‘ calendar/time information 


Constant 

Description 

YEAR 

The year portion of the calendar date 

MONTH 

The month portion of the calendar date 

DATE 

The day of the month 

D A Y _ 0 F _MONTH 

Same as DAT E 

DAY_OF_YEAR 

The day number within the year 

D A Y _ 0 F _MONTH 

The day number within the month 

D A Y _ 0 F _ WE E K 

The day of the week (Sun—1, Mon—2, etc.) 

WE EK_0F_YEAR 

The week number within the year 

nz 

I — 

o 

1 

Ul_ 

O 

1 

U_l 

LU 

3= 

The week number within the month 

AM_ PM 

The indicator for AM or PM (AM—0 and PM—1) 

HOUR 

The hour in 12-hour notation 

HOUR_ OF _ DAY 

The hour in 24-hour notation 

Ml NUTE 

The minute within the hour 


confusion, we can use constants defined for months in the superclass Calendar 
(GregorianCalendar is a subclass of Calendar). Instead of remembering that the 
value 6 represents July, we can use the defined constant Calendar.JULY as 

GregorianCalendar i ndependenceDay = 

new Gregori anCaI endar ( 1 7 7 6, Calendar.JULY, 4); 

Table 3.8 explains the use of some of the more common constants defined in the 
Calendar class. 

When the date and time are February 13, 2008, 13:30 p.m. and we run the 
Ch3TestCalendar program, we will see the result shown in Figure 3.4. 


Wed Feb 13:30 

51 PST 2008 

YEAR: 

2008 

MONTH: 

1 

DATE: 

13 

DAY OF YEAR: 

44 

DAY OF MONTH: 

13 

DAY OF WEEK: 

4 

WEEK OF YEAR: 

7 

WEEK OF MONTH 

3 

AM PM: 

1 

HOUR: 

1 

HOUR OF DAY: 

13 

MINUTE: 

30 


Figure 3.4 Result of running the Ch3TestCalender program at February 13,2008,13:30 p.m. 
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Chapter 3 Sample Program: Display Calendar Info 
File: Ch3TestCal endar.j ava 

*/ 

import java.util.*; 
class Ch3TestCal endar { 

public static void mai n(Stri ng[] args) { 

Gr eg o r i anCaI e nda r cal = new Gr eg o r i anCaI e nda r ( ); 


Syst em, out. 

p r i 

nt 1 

n ( c a 1 . g e t T i me () ) ; 



Syst em, out. 

p r i 

nt 1 

n 

"" ) ; 




Syst em, out. 

p r i 

nt 1 

n 

"YEAR: 


11 + c a 1 . 

get ( Cal endar. YEAR)); 

Syst em, out. 

p r i 

nt 1 

n 

11 MONTH: 


11 + c a 1 , 

get ( Cal endar. MONTH) ); 

Syst em, out. 

p r I 

nt 1 

n 

" DATE: 


11 + c a 1 . 

get ( Cal endar. DATE )) ; 

Syst em, out. 

p r i 

nt 1 

n 

' DAY_ OF_ 

YEAR: 

■ 







+ c a 1 

, get(Ca1 

endar. DAY_OF_YEAR) ) ; 

Syst em, out. 

p r i 

nt 1 

n 

11 DAY_ OF_ 

MONTH: 

11 







+ c a 1 

, get(Ca1 

endar. DAY_OF_MONTH) ); 

Syst em, out. 

p r I 

nt 1 

n 

" DAY_ OF_ 

WEEK: 

11 







+ c a 1 

. get(Ca1 

endar. DAY_0F_ WEEK )) ; 

Syst em, out. 

p r i 

nt 1 

n 

" WE E K _ 0 F 

_ Y E A R: 

11 







+ c a 1 

. get(Ca1 

endar. WEEK_OF_YEAR) ); 

Syst em, out. 

p r i 

nt 1 

n 

" WE E K_ OF 

_ MONTH: 

11 







+ c a 1 

, get(Ca1 

endar. WEEK_ 0F_ MONTH) ) 

Syst em, out. 

p r i 

nt 1 

n 

"AM PM: 


" + c a 1 , 

getfCal endar. AM_PM) ); 

Syst em, out. 

p r i 

nt 1 

n 

" HOUR: 


11 + c a 1 . 

get ( Cal endar. HOUR) ); 

Syst em, out. 

p r i 

nt 1 

n 

" H0UR_OF 

_ DAY: 

11 







+ c a 1 

, get(Ca1 

endar. HOUR_0F_ DAY )); 

Syst em, out. 

p r i 

nt 1 

n 

" Ml NUTE: 


" + c a 1 , 

getfCal endar. Ml NUTE)) 


} 


Notice that the first line in the output shows the full date and time information. 
The full date and time information can be accessed by calling the calendar object’s 
getTime getTime method. This method returns the same information as a Date object. 

Notice also that we get only the numerical values when we retrieve the day 
of the week or month information. We can spell out the information by using the 
SimpleDateFormat class. Since the constructor of the SimpleDateFormat class ac¬ 
cepts only the Date object, first we need to convert a GregorianCalendar object to 
an equivalent Date object by calling its getTime method. For example, here’s how 
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we can display the day of the week on which our Declaration of Independence was 
adopted in Philadelphia: 


Chapter 3 Sample Program: Day of the week the Declaration of 

Independence was adopted 

File: Ch3l ndependenceDay.java 

*/ 


import java,util.*; 
import java.text.*; 

class C h 31 ndependence Day { 

public static void mai n(Stri ng[] args) { 

Gregori anCal endar i ndependenceDay 

= new Gregor i anCaI endar ( 1 7 7 6, Cal endar.J ULY, 4): 

Si mpI eDateFor mat sdf = new Si mpl eDateFor mat (" EEEE" ) ; 


} 


System, out. pri ntl n("l t was adopted on " 

+ sdf. formatfi ndependenceDay.getTI me () )) : 


Let’s finish the section with a sample program that extends the Ch3lndepen- 
denceDay program. We will allow the user to enter the year, month, and day; and we 
will reply with the day of the week of the given date (our birthday, grandparent’s 
wedding day, and so on). Here’s the program: 



*/ 


Chapter 3 Sample Program: Find the Day of Week of a Given Date 
File: Ch3Fi ndDayOfWeek.j ava 


import java.util.*: 
import java.text.*: 

class Ch3Fi ndDayOfWeek { 

public static void mai n(Stri ng[] args) { 

int year, mo nth, day: 

GregorianCalendar cal; 

SI mp I e Da t e F o r ma t sdf; 
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Scanner scanner 
scanner, use Del i 


= new Scanner! Syst em. in); 
ni t e r ( S y s t e m. getProperty("l i n e. separator' 1 )); 


System, out. print! "Year i 
year = scanner.nextlnti 


yyyy) 


System, out. pri nt("Month (1-12): " 
mo nth = scanner. nextlntf); 

System, out. pri nt("Day ( 1- 31) : " ) ; 
day = scanner. nextlntf); 

cal = new GregorianCaI endar ( year, 
sdf = new Simple Da t e F o r ma t ( " E E E E' 

System, out. pri n 11 n ( "" ) ; 

System, out. pri n 11 n ( " Day of Week: 


month-1, day); 


+ s d f. f o r ma t ( c a I . g e t T i me ( )) ) 


Notice that we are allowing the user to enter the month as an integer be¬ 
tween 1 and 12, so we need to subtract 1 from the entered data in creating a new 
GregorianCalendar object. 


O 




lou 

Might 
Want to 
Know 


The Gregorian calendar system was adopted by England and its colonies, including the 
colonial United States, in 1752. So the technique shown here works only after this 
adoption. For a fascinating story about calendars, visit 

http://webexhibits.org/calendars/year-countries.html 


o 


Vl 


I oil 

' Might 
Want to 
Know 


Running Ch3lndpendenceDay will tell you that our venerable document was signed 
on Thursday. History textbooks will say something like "the document was formally 
adopted July 4,1776, on a bright, but cool Philadelphia day" but never the day of the 
week. Well, now you know. See how useful Java is? By the way, the document was 
adopted by the Second Continental Congress on July 4, but the actual signing did 
not take place until August 2 (it was Friday—what a great reason for a TGIF party) 
after the approval of all 13 colonies. For more stories behind the Declaration of 
Independence, visit 

http://www.ushistory.org/declaration/ 
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3.9 Sample Development 


Loan Calculator 

In this section, we develop a simple loan calculator program. We develop this program by 
using an incremental development technique, which develops the program in small in¬ 
cremental steps. We start out with a bare-bones program and gradually build up the pro¬ 
gram by adding more and more code to it. At each incremental step, we design, code,and 
test the program before moving on to the next step.This methodical development of a 
program allows us to focus our attention on a single task at each step, and this reduces 
the chance of introducing errors into the program. 

Problem Statement 

The next time you buy a new TV or a stereo, watch out for those "0% down, 0% interest 
until next July" deals. Read the fine print, and you'll notice that if you don't make the full 
payment by the end of a certain date, hefty interest will start accruing. You may be better 
off to get an ordinary loan from the beginning with a cheaper interest rate. What matters 
most is the total payment (loan amount plus total interest) you'll have to make.To com¬ 
pare different loan deals, let's develop a loan calculator. Here's the problem statement: 

Write a loan calculator program that computes both monthly and total 
payments for a given loan amount, annual interest rate, and loan period. 

Overall Plan 

Our first task is to map out the overall plan for development. We will identify classes nec¬ 
essary for the program and the steps we will follow to implement the program. We begin 
with the outline of program logic. Fora simple program such as this one, it is kind of obvi¬ 
ous; but to practice the incremental development, let's put down the outline of program 
flow explicitly. We can express the program flow as having three tasks: 

program 1. Get three input values: loanAmount, interestRate, and loanPeriod. 

tasks 

2. Compute the monthly and total payments. 

3. Output the results. 

Having identified the three major tasks of the program, we now identify the classes 
we can use to implement the three tasks. For input and output, we continue to use the 
Scanner class and System.out (PrintStream). For computing the monthly and total 
payments, there are no standard classes that will provide such computation, so we have 
to write our own code. 

The formula for computing the monthly payment can be found in any mathemat¬ 
ics book that covers geometric sequences. It is 


LXR 

Monthly payment = ■, _ [1/0 + r)] n 
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where L is the loan amount,/? is the monthly interest rate, and N is the number of payments. 
The monthly rate/? is expressed in a fractional value,for example, 0.01 for 1 percent monthly 
rate. Once the monthly payment is derived, the total payment can be determined by mul¬ 
tiplying the monthly payment by the number of months the payment is made. Since the 
formula includes exponentiation, we will have to use the pow method of the Math class. 

Let's summarize what we have decided so far in a design document: 


Design Document: LoanCal cui ator 

Class 

Purpose 

LoanCalc u1 ator 

The main class of the program. 

Scanner 

The class is used to get three input values: loan amount, 
annual interest rate, and loan period. 

Pr i nt St r ea m 
(System, out) 

Ma t h 

S y S t e m. o U t is used to display the input values and two 
computed results: monthly payment and total payment. 

The pow method is used to evaluate exponentiation in the 
formula for computing the monthly payment. This class is 
from j a v a. 1 a n g . Note: You don't have to import 
j a v a. 1 a n g .The classes in j a v a. 1 a n g are available to a 
program without importing. 


develop¬ 
ment steps 


The program diagram based on the classes listed in the design document is shown 
in Figure 3.5. Keep in mind that this is only a preliminary design. The preliminary docu¬ 
ment is really a working document that we will modify and expand as we progress 
through the development steps. 

Before we can actually start our development, we must sketch the steps we will 
follow to implement the program. There is more than one possible sequence of steps to 
implement a program, and the number of possible sequences will increase as the program 
becomes more complex. For this program, we will implement the program in four steps: 

1. Start with code to accept three input values. 

2. Add code to output the results. 

3. Add code to compute the monthly and total payments. 

4. Update or modify code and tie up any loose ends. 

Notice how the first three steps are ordered. Other orders are possible to develop 
this program.So why did we choose this particular order?The main reason is our desire to 
defer the most difficult task until the end. It's possible, but if we implement the computa¬ 
tion part in the second incremental step, then we need to code some temporary output 
routines to verify that the computation is done correctly. Flowever, if we implement the 
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Figure 3.5 The object diagram for the program LoanCalculator. 


real output routines before implementing the computation routines, then there is no 
need for us to worry about temporary output routines. As for step 1 and step 2, their rela¬ 
tive order does not matter much. We simply chose to implement the input routine before 
the output routine because input comes before output in the program. 

Step 1 Development: Input Three Data Values 

The next task is to determine how we will accept the input values. The problem statement 
does not specify the exact format of input, so we will decide that now. Based on how peo¬ 
ple normally refer to loans, the input values will be accepted in the following format: 


step 1 
design 



Be aware that we need to convert the annual interest rate to the monthly interest rate and 
the input value loan period to the number of monthly payments, to use the given 
formula. In this case, the conversion is very simple, but even if the conversion routines 
were more complicated, we must do the conversion. It is not acceptable to ask users to 
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step 1 code 


enter an input value that is unnatural to them. For example, people do not think of inter¬ 
est rates in fractional values such as 0.07.They think of interest in terms of percentages 
such as 7 percent. Computer programs work for humans, not the other way round. 
Programs we develop should not support an interface that is difficult and awkward for 
humans to use. 

When the user inputs an invalid value, for example, an input string value that can¬ 
not be converted to a numerical value or that converts to a negative number, the program 
should respond accordingly, such as by printing an error message. We do not possess 
enough skills to implement such a robust program yet, so we will make the following 
assumptions: (1) The input values are nonnegative numbers, and (2) the loan period is a 
whole number. 

One important objective of this step is to verify that the input values are read 
in correctly by the program. To verify this, we will echo-print the input values to 

System.out. 

Here's our step 1 program: 


Chapter 3 Sample Develop me nt: Loan Calculator (Step 1) 

FIle: Stepl/Ch3LoanCal cul ator.j ava 
Step 1: Input Data Values 

*/ 

import java,util.*; 

class Ch3LoanCal cul ator { 

public static void main(Stri ng [1 ar gs ) { 

double I o a n A mount, 

annual I nt er est Rat e; 

i nt I oanPeri od; 

Scanner scanner = new Scanner ( System. In); 

scanner, use Deli mi ter(Syste m. getPropertyl“ line, separator")); 

II get input values 

Syst em. out. pr i nt ( * 11 Loa n Amount ( Dol I ars+Cents) : "); 
loanAmount = scanner. nextDoubI e (); 

System, out. print! "Annual Interest Rate (e.g., 9,5): "); 
annual I nterestRate = scanner. nextDoubI e () ; 
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System, out. print! "Loan Period - # of years: "); 
loanPeriod = scanner, nextl nt(); 

//echo print the input values 
S y s t e m. o u t. p r i n 11 n ( “" ) ; 

System, out. printlnf" Loan Amount: $" + I o a n A mount); 

System, out. println!" Annual Interest Rate: " 

+ a n n u a I I n t e r e s t R a t e + " %" ) ; 

System, out. println! “Loan Period (years): " + loanPeriod); 

} 

} 


To verify the input routine is working correctly, we run the program multiple times 
and enter different sets of data. We make sure the values are displayed in the standard 
output window as entered. 


Step 2 Development: Output Values 

step 2 The secon d step is to add code to display the output values. We will use the standard out- 

design put window for displaying output values. We need to display the result in a layout that is 

meaningful and easy to read. Just displaying numbers such as the following is totally 
unacceptable. 


1 3 2. 1 5 1. 1 5 8 5 8. 1 


We must label the output values so the user can tell what the numbers represent. In addi¬ 
tion, we must display the input values with the computed result so it will not be mean¬ 
ingless. Which of the two shown in Figure 3.6 do you think is more meaningful? The 
output format of this program will be 


F o r 

Loan A mount: $ <amount> 

Annual Interest Rate: < a n n u a I interest r a t e > % 

Loan Period (years): <y e a r > 

Monthly payment is $ < monthly p a y me n t > 

TOTAL payment is $ <t o t a I p a y me n t > 


with <amount>, <annual interest rate>, and others replaced by the actual figures. 
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Only the computed 
values (and their 
labels) are shown. 


Monthly payment: $ 143.47 

Total payment: $ 17216.50 


Both the input and 
computed values (and 
their labels) are shown. 


For 

Loan Amount: 

Annual Interest Rate: 
Loan Period (years): 

Monthly payment is 
TOTAL payment is 


$ 10000.00 
12 . 0 % 

10 

$ 143.47 
$ 17216.50 


Figure 3.6 Two different display formats, one with input values displayed and the other with only the 
computed values displayed. 

Since the computations for the monthly and total payments are not yet imple¬ 
mented, we will use the following dummy assignment statements: 

monthl yPayment = 135.15; 
total Payment = 15858.10; 

We will replace these statements with the real ones in the next step, 
step 2 code Here's our step 2 program with the newly added portion surrounded by a rectangle 

and white background: 



Chapter 3 

S 

a mp 1 

e Devel 

op 

me n t : 

Loan C a 1c u 

File 

!: St e 

P2 

/ Ch3 

Lo a n Ca1 

c u 

1 a t o r. 

java 

Step 2 : D 

i s 

pi ay 

the Re 

s u 

1 t s 


*1 








i mpor t 

java. 

ut 

i 1 . * 

; 




class Ch3Loa 

nC 

a 1 c j 

1 a t o r { 




publ 

i c st 

at 

i c v 

o i d mai 

n ( 

St ri ng 

[] args) { 


doubl 

e 

1 oa 

n A mo u n t 

, 






a n n 

ua 1 1 nt e 

r e 

s t Ra t e 



doubl 

e 

mo n 

t hi yPay 

me 

nt, 





t ot 

a 1 P a y me 

nt 

j 



i nt 


1 oa 

nPeri od 





www.it-ebooks.info 















3.9 Sample Development 131 


} 

} 


step 2 test 


step 3 
design 


Scanner scanner = new Scanner! Syst em. in); 

scanner, useDeli mi ter(System, getProperty("l i ne. separator")); 

II get input values 

System, out. print! 11 Loan Amount (Dollars+Cents): "); 
loanAmount = scanner. nextDoubl e(); 

System, out. print! “ Annual Interest Rate ( e. g. , 9.5): "); 
annua I I nterest Ra te = s c a nner. nextDoubI e ( ) ; 

System, out. print! "Loan Period - # of years: "); 
loanPeriod = scanner, nextl nt(); 

//compute the monthly and total payments 

monthlyPayment = 132.15; 
totalPayment = 15858.10; 

//display the result 
System, out. pri ntl n(""); 

System, out. println!" Loan Amount: $" + loanAmount); 

System, out. pri ntl n ( “Annual Interest Rate:" 

+ a n n u a I I n t e r e s t R a t e + " %" ) ; 

System, out. println! "Loan Period (years): " + loanPeriod); 

System, out. println! " \ n" ) ; II skip two lines 

System, out, println! "Monthly payment is $ " + monthlyPayment); 

System, out. println!" TOTAL payment is $ " + totalPayment); 


To verify the output routine is working correctly, we run the program and verify the 
layout. Most likely, we have to run the program several times to fine-tune the arguments for 
the println methods until we get the layout that looks clean and nice on the screen. 

Step 3 Development: Compute Loan Amount 

We are now ready to complete the program by implementing the formula derived in the 
design phase.The formula requires the monthly interest rate and the number of monthly 
payments. The input values to the program, however, are the annual interest rate and the 
loan period in years. So we need to convert the annual interest rate to a monthly interest 
rate and the loan period to the number of monthly payments.The two input values are 
converted as 

mont hi yl nt er est Rat e = a n n u a I I nt e r e s t Ra t e / 100.0 / MONTHSI NYEAR; 
n u mb e r Of P a y me nt s = loanPeriod * MONTHSI NYEAR; 
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where MONTHS_IN_YEAR is a symbolic constant with value 12. Notice that we need to 
divide the input annual interest rate by 100 first because the formula for loan computa¬ 
tion requires that the interest rate be a fractional value, for example, 0.01, but the input 
annual interest rate is entered as a percentage point, for example, 12.0. Please read Exer¬ 
cise 26 on page 147 for information on how the monthly interest rate is derived from a 
given annual interest rate. 

The formula for computing the monthly and total payments can be expressed as 
monthl yPayment = ( I o a n A mount * monthl yl nterestRate) 


(1 - Mat h. p o w( 1 /(I + monthi yl nterestRat e) , 
numberOf Payment s) ) ; 

total Payment = monthl yPayment * number Of Payments; 


step 3 code 


Let's put in the necessary code for the computations and complete the program. 
Here's our program: 


Chapter 3 Sample Development: Loan Calculator (Step 3) 
FiI e: Step3/Ch3LoanCalcul ator.j ava 
Step 3: Display the Results 

*/ 

import java.util.*; 
class Ch3LoanCal cul ator { 

public static void main(String[] args) { 


final 

i nt MONTHSJ N _ Y E A R = 12; 


double 

1 o a n A mo u n t, 



annual 1 nterestRate; 


double 

monthl yPayment, 



total Payment; 


double 

monthl yl nterestRate; 


i nt 

1 oa nPeriod; 
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} 

} 


step 3 test 


i nt numberOf Payment s; 

Scanner scanner = new Scanner(System. in); 

scanner, use Deli mi ter(Syste m. getProperty!" line, separator")); 

II get input values 

System, out. pri nt("Loan Amount (DolI ars+Cents): "); 
loanAmount = scanner, next Doublet); 

System, out. print! “Annual Interest Rate (e. g. , 9.5): "); 
a nn ua I I nt er es t Ra t e = s c a n ne r. next Do ub I e () ; 

System, out, print! 11 Loan Period - # of years: "); 
loanPeriod = scanner, ne x tI n t ( ); 


//compute the monthly and total payments 

monthi yl nterestRate = annuaI I nterestRate / MONTHS_I N_YEAR / 100; 
numberOfPayments = loanPeriod * MONTHS_I N_YEAR; 

monthlyPayment = (loanAmount * monthl yl nterestRate)/ 

(1 - Mat h. pow ( 1/ ( 1 + mont hi yl nt er est Rat e) , 
number Of Payment s ) ); 

total Payment = monthlyPayment * number Of Payments; 


//display the result 
System, out, pri n 11 n ( ""); 

System, out, println!" Loan A mount: $ “ + loanAmount); 

System, out, println!" Annual Interest Rate: " 

+ a n n u a I I n t e r e s t R a t e + " %" ) ; 

System, out, println! “Loan Period (years): " + loanPeriod); 

System, out, println! " \ n" ) ; //skip two lines 

System, out, println! “Monthly payment is $ " + monthlyPayment); 

System, out, println! “ TOTAL payment is $ " + totalPayment); 


After the program is coded, we need to run the program through a number of tests. 
Since we made the assumption that the input values must be valid, we will test the pro¬ 
gram only for valid input values. If we don't make that assumption, then we need to test 
that the program will respond correctly when invalid values are entered. We will perform 
such testing beginning in Chapter 5.To check that this program produces correct results, 
we can run the program with the following input values. The right two columns show the 
correct results. Try other input values as well. 
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Input 


Output 

(shown up to three decimal 
places only) 

Loan 

Annual 

Interest 

Loan 

Period 

Monthly 

Total 

Amount 

Rate 

(Years) 

Payment 

Payment 

10000 

10 

10 

132.151 

15858.088 

15000 

7 

15 

134.824 

24268.363 

10000 

12 

10 

143.471 

17216.514 

0 

10 

5 

0.000 

0.000 

30 

8.5 

50 

0.216 

129.373 


step 4 
design 


step 4 code 


Step 4 Development: Finishing Up 

We finalize the program in the last step by making any necessary modifications or addi¬ 
tions. We will make two additions to the program. The first is necessary while the second 
is optional but desirable. The first addition is the inclusion of a program description. One 
of the necessary features of any nontrivial program is the description of what the pro¬ 
gram does for the user. We will print out a description at the beginning of the program to 
System.out. The second addition is the formatting of the output values. We will format 
the monthly and total payments to two decimal places, using a DecimalFormat object. 
Here is our final program: 



Chapter 3 Sample Develop me nt: Loan Calculator (Step 4) 
File: Step4/Ch3LoanCal cul ator.j ava 
Step 4: Finalize the program 

*/ 

import java,util.*; 
ji mpor t j a va. t ext. *; 
class C h 3L o a n Calculator { 

public static void main(String[] args) { 
f i nal i nt MONTHS,! N_YEAR = 12; 
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double 

1 o a n A mo u n t, 
annual 1 nterestRate; 

doubl e 

monthl yPayment, 
total Payment; 

double 

monthl yl nterestRate; 

i nt 

1 oa nPeriod; 

i nt 

n u mbe r Of Pay me nt s; 


Scanner scanner = new Scanner(System, in); 

scanner, useDeI i mi ter(System. getProperty("l i ne, separator")); 

D e c i ma I F o r ma t d f = new D e c i ma I F o r ma t ( "0. 00"); 

//describe the program 

System, out. p r i n 11 n (" This program computes the monthly and total"); 
System, out. printlnf" pay me nts for a given loan a mount, annual "); 
System, out. p r i n 11 n ( " interest rate, and loan period."); 

System, out. p r i n 11 n ( " Loan amount in dollars and cents, 

e, g,, 12345.50"); 

System, out. p r i n 11 n ( " Annual interest rate in percentage, 

e. g., 12.75"); 

System, out. printing Loan period in number of years, e. g. , 15"); 
System, out. pri ntl n("\n"); II skip two lines 


II get input values 

System, out. print! "Loan Amount (Dollars+Cents): "); 
loanAmount = scanner. nextDoubl e( ); 

System, out. print! "Annual Interest Rate ( e. g. , 9.5): "); 
a n n ua I I nt e r es t Ra t e = s c a n ne r. ne xt Do u b I e ( ); 

System, out. print! "Loan Period - # of years: "); 
loanPeriod = scanner, next I n t ( ); 

//compute the monthly and total pay me nts 

monthlyl nterestRate = annuaI I nterestRate / MONTHS_I N_YEAR / 100; 
number Of Payments = loanPeriod * MO NTHS_I N_YEAR; 

monthlyPayment = (loanAmount * monthl yl nterestRate) / 

(1 - Mat h. po w( 1/ ( 1 + mont hi yl nt er est Rat e) , 
n umbe r Of Pa y men t s ) ) ; 

total Payment = monthlyPayment * number Of Pay me nts; 

//display the result 
System, out. pri ntl n ( "" ) ; 

System, out. pri ntl n(" Loan A mount: $“ + I o a n A mount); 
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— continued jl^fP 




System. 

out 

pr i 

nt 

n ( " A n n u a 1 

1 n t e r e s t 

Rate: 

i. 







+ a n 

n u a 1 1 n t e r e s t R a t e + " %" ) 

System. 

out 

pr i 

nt 

n ( "Loan Pe 

riod (yea 

rs) : 

" + loanPeriod); 

System. 

out 

pr i 

nt 

n ( " \ n " ); / 

/ skip two 

1 i nes 


System. 

out , 

pr i 

nt 

n(" Mont hiy 

p a y me n t 

i s $ 

" 







+ df. 

format (monthl yPayment )) 

System. 

out, 

pr i 

nt 

n ( " TOTAL 

p a y me n t 

i s $ 

11 







+ df. 

format (total Payment)); 


} 

} 


We repeat the test runs from step 3 and confirm the modified program still runs 
correctly. Since we have not made any substantial additions or modifications, we fully 
expect the program to work correctly. However, it is very easy to introduce errors in cod¬ 
ing, so even if we think the changes are trivial, we should never skip the testing after even 
a slight modification. 



hings to Remember 


Always test after making any additions or modifications to a program, no matter 
how trivial you think the changes are. 


3.10 Numerical Representation ( Optional ) 

In this section we explain how integers and real numbers are stored in memory. 
Although computer manufacturers have used various formats for storing numerical 
twos values, today’s standard is to use the twos complement format for storing integers 

complement anc | the floating-point format for real numbers. We describe these formats in this 

section. 

An integer can occupy 1, 2, 4, or 8 bytes depending on which data type 
(i.e., byte, short, int, or long) is declared. To make the examples easy to follow, 
we will use 1 byte (= 8 bits) to explain twos complement form. The same principle 
applies to 2, 4, and 8 bytes. (They just utilize more bits.) 
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sign bit 


The following table shows the first five and the last four of the 256 positive 
binary numbers using 8 bits. The right column lists their decimal equivalents. 



Using 8 bits, we can represent positive integers from 0 to 255. Now let’s see 
the possible range of negative and positive numbers that we can represent, using 
8 bits. We can designate the leftmost bit as a sign bit. 0 means positive and 1 means 
negative. Using this scheme, we can represent integers from —127 to +127 as 
shown in the following table: 


8-Bit Binary Number 
(with a Sign Bit) 

Decimal Equivalent 

0 0000000 

+ 0 

0 0000001 

+1 

0 0000010 

+ 2 

0 1111111 

+ 127 

1 0000000 

-0 

1 0000001 

-1 

1 1111110 

-126 

1 1111111 

-127 


Notice that zero has two distinct representations (+0 = 00000000 and — 0 = 
10000000), which adds complexity in hardware design. Twos complement format 
avoids this problem of duplicate representations for zero. In twos complement for¬ 
mat, all positive numbers have zero in their leftmost bit. The representation of a 
negative number is derived by first inverting all the bits (changing Is to 0s and 0s to 
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floating-point 


Is) in the representation of the positive number and then adding 1. The following 
diagram illustrates the process: 


13 = 00001101 

invert 
11110010 
add 1 

- 13 = 11110011 

The following table shows the decimal equivalents of 8-bit binary numbers by 
using twos complement representation. Notice that zero has only one representation. 


8-Bit Binary Number 
(Twos Complement) 

Decimal 

Equivalent 

00000000 

+ 0 

00000001 

+1 

00000010 

+ 2 

01111111 

+ 127 

10000000 

-128 

10000001 

-127 

11111110 

-2 

11111111 

-1 


Now let’s see how real numbers are stored in memory in floating-point format. 
We present only the basic ideas of storing real numbers in computer memory here. 
We omit the precise details of the Institute of Electronics and Electrical Engineers 
(IEEE) Standard 754 that Java uses to store real numbers. 

Real numbers are represented in the computer by using scientific notation. In 
base-10 scientific notation, a real number is expressed as 

A X 10" 

where A is a real number and N is an integral exponent. For example, the mass of a 
hydrogen atom (in grams) is expressed in decimal scientific notation as 1.67339 X 
10“ 24 , which is equal to 0.00000000000000000000000167339. 

We use base-2 scientific notation to store real numbers in computer memory. 
Base-2 scientific notation represents a real number as follows: 

A X 2" 

The float and double data types use 32 and 64 bits, respectively, with the num¬ 
ber A and exponent N stored as follows: 
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normalized The value A is a normalized fraction, where the fraction begins with a binary point, 

fraction followed by a 1 bit and the rest of the fraction. ( Note: A decimal number has a dec¬ 

imal point; a binary number has a binary point.) The following numbers are sample 
normalized and unnormalized binary fractions: 



Since a normalized number always start with a 1. this bit does not actually 
have to be stored. The following diagram illustrates how the A value is stored. 


.10 110 111 


N 


0 1 101 1 100 ... 0 0 


The sign bit S indicates the sign of a number, so A is stored in memory as an un¬ 
signed number. The integral exponent N can be negative or positive. Instead of using 
excess format twos complement for storing N, we use a format called excess format. The 8-bit ex¬ 
ponent uses the excess-127 format, and the 11-bit exponent uses the excess-1023 
format. We will explain the excess-127 format here. The excess-1023 works 
similarly. With the excess-127 format, the actual exponent is computed as 

N - 127 

Therefore, the number 127 represents an exponent of zero. Numbers less than 127 
represent negative exponents, and numbers greater than 127 represent positive 
exponents. The following diagram illustrates that the number 125 in the exponent 
held represents 2 125-127 = 2 “ 2 . 

S_N__A_ 

01111101 

t 

201111101-127 — 2125-127 — 2“2 
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Summary 

• 

• 

• 

• 

A variable is a memory location in which to store a value. 

A variable has a name and a data type. 

A variable must be declared before we can assign a value to it. 

There are six numerical data types in Java: byte, short, int, long, float, and 
double. 

• 

Object names are synonymous with variables whose contents are memory 
addresses. 

• 

Numerical data types are called primitive data types, and objects are called 
reference data types. 

• 

• 

• 

Precedence rules determine the order of evaluating arithemetic expressions. 

Symbolic constants hold values just as variables do, but we cannot change 
their values. 

The standard classes introduced in this chapter are 


Math 

GregorianCalendar 

DecimalFormat 

• 

System.out is used to output multiple lines of text to the standard output window. 

• 

System, in is used to input a stream of bytes. We associate a Scanner object to 
System.in to input primitive data type. 

• 

• 

• 

The Math class contains many class methods for mathematical functions. 

The GregorianCalendar class is used in the manipulation of calendar 
information. 

The DecimalFormat class is used to format numerical data. 

• 

(Optional ) Twos complement format is used for storing integers, and 
floating-pointing format is used for storing real numbers. 

Key Cone 

e p t s 


variables 

primitive data types 
reference data types 
arithmetic expression 
arithmetic operators 
precedence rules 
typecasting 

implicit and explicit casting 


assignment conversion 
constants 
standard output 
standard input 
echo printing 

twos complement ( optional ) 
floating point ( optional) 
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Review Exercises 

1. Suppose we have the following declarations: 

inti = 3, j = 4, k = 5; 
float x = 3 4. 5f, y = 12.25f; 

Determine the value for each of the following expressions, or explain why it 
is not a valid expression. 

a (x + 1.5 ) / ( 2 5 0.0 * ( i / j ) ) 

b. x + 1. 5 / 2 5 0. 0 * i / j 

c. - x * - y * ( i + j ) / k 
d ( i / 5) * y 

e. Ma t h. mi n ( i , Ma t h. mi n (j , k) ) 

f. Mat h. exp( 3, 2) 

g. y % x 

h. Mat h. pow( 3, 2) 

i. ( i n t ) y % k 

j. i / 5 * y 

2. Suppose we have the following declarations: 

int m, n, i = 3, j = 4, k = 5; 
float v, w, x = 3 4. 5f, y = 12.25f; 

Determine the value assigned to the variable in each of the following 
assignment statements, or explain why it is not a valid assignment. 

a w = Math. pow(3, Math. pow(i ,j )); 

b. v = x / i ; 

c. w = Math.ceil(y) % k; 
dn=(int)x/y*i/2; 

e. x = Ma t h. s q r t ( i * i - 4 * j * k) ; 

f. m = n + i * j ; 

g. n = k / (j * i ) * x + y; 

h. i = i +1; 

i. w = fl o a t ( x + i); 

j. x = x / i / y / j ; 

3. Suppose we have the following declarations: 

int i , j ; 

fI oat x, y; 
double u. v; 

Which of the following assignments are valid? 

a i = x; 

b. x = u + y; 

c. x = 23.4 + j * y; 
d v = (i nt) x; 

e. y = j / i * x; 
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4. Write Java expressions to compute each of the following. 

a The square root of B 2 + 4AC (A and C are distinct variables) 

b. The square root of X + 4Y 3 

c. The cube root of the product of X and Y 

d. The area 77R 2 of a circle 

5. Determine the output of the following program without running it. 


class Tes t Out put { 




public static 

voi 

d ma i n ( S t r i n g 

System, out 

■ Pr 

i ntl 

n ( " 0 n e" ) ; 

System, out 

, pr 

i nt ( 

"Two"); 

System, out 

. pr 

i nt ( 

"In"); 

System, out 

, pr 

i nt ( 

"Three"); 

System, out 

■ Pr 

i ntl 

n ( " F 0 u r " ) 

System, out 

■ Pr 

I nt ( 

“ \ n" ); 

System, out 

, pr 

i nt ( 

"FI v e" ) ; 

System, out 

, pr 

i ntl 

n ( " S i x" ) ; 


} 

} 

6. Determine the output of the following code. 

i n t x, y; 
x = 1; 
y = 2; 

System, out. pri ntl n("The output is " + x + y ); 

System, out. p r i n 11 n ( " The output is " + ( x + y) ); 

Level 1 Programming Exercises ★ 

7. Write a program to convert centimeters (input) to feet and inches (output). 

1 in = 2.54 cm. 

8. Write a program that inputs temperature in degrees Celsius and prints out the 
temperature in degrees Fahrenheit. The formula to convert degrees Celsius 
to equivalent degrees Fahrenheit is 

Fahrenheit = 1.8 X Celsius + 32 

9. Write a program that accepts a person’s weight and displays the number of 
calories the person needs in one day. A person needs 19 calories per pound 
of body weight, so the formula expressed in Java is 

calories = bodyWei ght * 19; 

{Note: We are not distinguishing between genders.) 
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10. Write a program that does the reverse of Exercise 9, that is, input degrees 
Fahrenheit and prints out the temperature in degrees Celsius. The formula to 
convert degrees Fahrenheit to equivalent degrees Celsius is 


Celsius = ^ X (Fahrenheit — 32) 


11. Write a program that inputs the year a person is born and outputs the age of 
the person in the following format: 


You were born in 1990 and will be (are) 18 this year. 


12. A quantity known as the body mass index (BMI) is used to calculate the risk 
of weight-related health problems. BMI is computed by the formula 



where w is weight in kilograms and h is height in centimeters. A BMI of 
about 20 to 25 is considered “normal.” Write an application that accepts 
weight and height (both integers) and outputs the BMI. 

13. If you invest P dollars at R percent interest rate compounded annually, in 
N years, your investment will grow to 


P( 1 + R/10Q) n 


dollars. Write an application that accepts P, R, and N and computes the 
amount of money earned after N years. 

14. The volume of a sphere is computed by the equation 



where V is the volume and r is the radius of the sphere. Write a program that 
computes the volume of a sphere with a given radius r. 

Level 2 Programming Exercises ★★ 

15. The velocity of a satellite circling around the Earth is computed by the 
formula 



where M v = 5.98 X 1() 24 kg is the mass of the Earth, r the distance from the 
center of the Earth to the satellite in meters, and G = 6.67 X 10“ 11 m 3 /kg • s 2 
the universal gravitational constant. The unit of the velocity v is m/s. Write a 
program that inputs the radius r and outputs the satellite’s velocity. Confirm 
that a satellite that is closer to the Earth travels faster. Define symbolic 
constants for M E and G. The distance to the Hubble Space Telescope from 
the center of the Earth, for example, is approximately 6.98 X 10 6 m. 
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16. Your weight is actually the amount of gravitational attraction exerted on 
you by the Earth. Since the Moon’s gravity is only one-sixth of the Earth’s 
gravity, on the Moon you would weigh only one-sixth of what you weigh on 
Earth. Write a program that inputs the user’s Earth weight and outputs her or 
his weight on Mercury, Venus, Jupiter, and Saturn. Use the values in this 
table. 

Plaiet MUtiply the Ea-th Weight by 


Mercury 

0.4 

Venus 

0.9 

Jupiter 

2.5 

Saturn 

1.1 


17. When you say you are 18 years old, you are really saying that the Earth has 
circled the Sun 18 times. Since other planets take fewer or more days than 
Earth to travel around the Sun, your age would be different on other planets. 
You can compute how old you are on other planets by the formula 

x X 365 


where x is the age on Earth, y is the age on planet Y, and d is the number of 
Earth days the planet Y takes to travel around the Sun. Write an application 
that inputs the user’s Earth age and print outs his or her age on Mercury, 
Venus, Jupiter, and Saturn. The values for d are listed in the table. 

d = Approximate Nlinber of Ea-th 
Days for This Plaiet to Travel 


Plaiet 

a-oitid the 

Mercury 

88 

Venus 

225 

Jupiter 

4,380 

Saturn 

10,767 


18. Write a program to solve quadratic equations of the form 

Ax 2 + Bx + C = 0 


where the coefficients A, B, and C are real numbers. The two real number 
solutions are derived by the formula 

—B ± Vfi 2 - 4AC 

x =- 

2 A 

For this exercise, you may assume that A =£ 0 and the relationship 

B 2 >4AC 

holds, so there will be real number solutions for x. 
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19. Write a program that determines the number of days in a given semester. 
Input to the program is the year, month, and day information of the first and 
the last days of a semester. Hint: Create GregorianCalendar objects for the 
start and end dates of a semester and manipulate their DAY_OF_YEAR data. 

20. Modify the Ch3FindDayOfWeek program by accepting the date information 
as a single string instead of accepting the year, month, and day information 
separately. The input string must be in the MM/dd/yyyy format. For 
example, July 4, 1776, is entered as 07/04/1776. There will be exactly two 
digits for the month and day and four digits for the year. 

21. Leonardo Fibonacci of Pisa was one of the greatest mathematicians of the 
Middle Ages. He is perhaps most famous for the Fibonacci sequence, which 
can be applied to many diverse problems. One amusing application of the 
Fibonacci sequence is in finding the growth rate of rabbits. Suppose a pair of 
rabbits matures in 2 months and is capable of reproducing another pair every 
month after maturity. If every new pair has the same capability, how many 
pairs will there be after 1 year? (We assume here that no pairs die.) The table 
below shows the sequence for the first 7 months. Notice that at the end of the 
second month, the first pair matures and bears its first offspring in the third 
month, making the total two pairs. 


NlHiber of Pairs 


Month No. 


1 

2 

3 

4 

5 

6 
7 


1 

1 

2 

3 

5 

8 

13 


The /Vth Fibonacci number in the sequence can be evaluated with the formula 



Write an application that accepts N and displays F N . Note that the result of 
computation using the Math class is double. You need to display it as an 
integer. 

22. According to Newton’s universal law of gravitation, the force F between two 
bodies with masses Mi and M 2 is computed as 



where d is the distance between the two bodies and k is a positive real 
number called the gravitational constant. The gravitational constant k is 
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approximately equal to 6.67E-8 dyn • cm 2 /g 2 . Write an application that 
(1) accepts the mass for two bodies in grams and the distance between the 
two bodies in centimeters and (2) computes the force F. Use the standard 
input and output, and format the output appropriately. For your information, 
the force between the Earth and the Moon is 1.984E25 dyn. The mass of the 
earth is 5.983E27 g, the mass of the moon is 7.347E25 g, and the distance 
between the two is 3.844E10 cm. 


23. Dr. Caffeine’s Law of Program Readability states that the degree of program 
readability R (whose unit is mocha) is determined as 

CT 2 


R = k 


U 3 


where k is Ms. Latte’s constant, C is the number of lines in the program that 
contain comments, T is the time spent (in minutes) by the programmer 
developing the program, and V is the number of lines in the program that 
contain nondescriptive variable names. Write an application to compute the 
program readability R. Ms. Latte’s constant is 2.5E2 mocha lines 2 /min 2 . 
(Note: This is just for fun. Develop your own law, using various functions 
from the Math class.) 


Level 3 Programming Exercises ★★★ 

24. Write a program that accepts the unit weight of a bag of coffee in pounds and 
the number of bags sold and displays the total price of the sale, computed as 

totalPrice = unit Weight * number Of Units * 5.99; 

total Pri ceWi thTax = totalPrice + totalPrice * 0.0725; 

where 5.99 is the cost per pound and 0.0725 is the sales tax. Display the 
result in the following manner: 


Number of bags sold: 32 

Weight per bag: 5 lb 

Price per pound: $5.99 

Sales tax: 7.25% 


Total price: $ 1027.884 


Draw the program diagram. 

25. If the population of a country grows according to the formula 

lex 

y = ce 

where y is the population after x years from the reference year, then we can 
determine the population of a country for a given year from two census 
figures. For example, given that a country with a population of 1,000,000 in 
1970 grows to 2,000,000 by 1990, we can predict the country’s population in 
the year 2000. Here’s how we do the computation. Letting x be the number 
of years after 1970, we obtain the constant c as 1,000,000 because 


www.it-ebooks.info 






Exercises 147 


1,000,000 = ce k0 = c 

Then we determine the value of k as 

y = I ,000,000e fa 

2,000,000 _ ^ 20k 
1 , 000,000 

1 , 2,000,000 

k = — In- 

20 1 , 000,000 


0.03466 


Finally we can predict the population in the year 2000 by substituting 
0.03466 for k and 30 for x (2000 — 1970 = 30). Thus, we predict 

y = l,000,000c°° 3466(30) « 2,828,651 


as the population of the country for the year 2000. Write an application that 
accepts five input values—year A, population in year A, year B, population 
in year B, and year C—and predict the population for year C. 

26. In Section 3.9, we use the formula 


to derive the monthly interest rate from a given annual interest rate, 
where MR is the monthly interest rate and AR is the annual interest 
rate (expressed in a fractional value such as 0.083). This annual interest 
rate AR is called the stated annual interest rate to distinguish it from the 
effective annual interest rate, which is the true cost of a loan. If the 
stated annual interest rate is 9 percent, for example, then the effective 
annual interest rate is actually 9.38 percent. Naturally, the rate that the 
financial institutions advertise more prominently is the stated interest 
rate. The loan calculator program in Section 3.9 treats the annual 
interest rate that the user enters as the stated annual interest rate. If the 
input is the effective annual interest rate, then we compute the monthly 
rate as 


MR = (1 + EAR) 1 / 12 — 1 

where EAR is the effective annual interest rate. The difference between 
the stated and effective annual interest rates is negligible only when 
the loan amount is small or the loan period is short. Modify the loan 
calculator program so that the interest rate that the user enters is 
treated as the effective annual interest rate. Run the original and modified 
loan calculator programs, and compare the differences in the monthly 
and total payments. Use loan amounts of 1, 10, and 50 million dollars 
with loan periods of 10, 20, and 30 years and annual interest rates of 
0.07, 0.10, and 0.18 percent, respectively. Try other combinations also. 
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Visit several websites that provide a loan calculator for computing 
a monthly mortgage payment (one such site is the financial page at 
www.cnn.com). Compare your results to the values computed by the 
websites you visited. Determine whether the websites treat the input 
annual interest rate as stated or effective. 

27. Ask the user to enter his or her birthday in the MM/DD/YYYY format and 
output the number of days between the birthday and today. This gives the 
person’s age in days. 


Development Exercises 

For the following exercises, use the incremental development methodology 
to implement the program. For each exercise, identify the program tasks, 
create a design document with class descriptions, and draw the program 
diagram. Map out the development steps at the start. State any assumptions 
you must make about the input. Present any design alternatives and justify 
your selection. Be sure to perform adequate testing at the end of each 
development step. 

28. Develop an application that reads a purchase price and an amount tendered 
and then displays the change in dollars, quarters, dimes, nickels, and 
pennies. Two input values are entered in cents, for example, 3480 for $34.80 
and 70 for $0.70. Display the output in the following format: 


Purchase Price: $ 34.80 

Amount Tendered: $ 40.00 


Your change is: $ 5.20 


5 one-dollar bill(s) 
0 quarter(s) 

2 dime(s) 

0 nickel (s) 

0 penn(y/ies) 


Thank you for your business. Come back soon. 


Notice the input values are to be entered in cents (int data type), but 
the echo printed values must be displayed with decimal points (float 
data type). 

29. MyJava Coffee Outlet runs a catalog business. It sells only one type of 
coffee beans, harvested exclusively in the remote area of Irian Jaya. The 
company sells the coffee in 2-lb bags only, and the price of a single 2-lb 
bag is $5.50. When a customer places an order, the company ships the 
order in boxes. The boxes come in three sizes: the large box holds 20 bags 
of 2 lb, the medium 10 bags, and the small 5 bags. The cost of a large 
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box is $1.80; a medium box, $1.00; and a small box, $0.60. The order is 
shipped in the least expensive manner. For example, the order of 52 bags 
will be shipped in four boxes: two large, one medium, and one small. The 
rule for packing is to fill the large and medium boxes completely; that is, 
the box is fully packed. Only the small boxes can have empty spaces. For 
example, to ship 52 bags, you could have used 3 large boxes, but that 
would leave the third box not fully packed. Develop a program that 
computes the total cost of an order. Display the output in the following 
format: 


Number of Bags Ordered: 

52 - 

Boxes Used: 


2 Large - 

$3. 60 

1 Medium - 

$1. 00 

1 S ma 1 1 

$0. 60 

Your total cost is: $ 

291.20 


30. Repeat Exercise 29, but this time, accept the date when the order is placed 
and display the expected date of arrival. The expected date of arrival is two 
weeks (14 days) from the date of order. The order date is entered as a 
single string in the MM/dd/yyyy format. For example, November 1, 2008 
is entered as 11/01/2008. There will be exactly two digits each for the 
month and day and four digits for the year. Display the output in the 
following format: 


Number of Bags Ordered 

: 52 - $ 286. 

00 


Boxes Used: 




2 Large - 

$3. 60 



1 Medium - 

$1. 00 



1 S ma 1 1 

$0, 60 



Your total cost is: $ 

291. 20 



Da t e of Or de r: 

November 

1 , 

2 0 0 8 

Expected Date of Ar ri v 

al : November 

15, 

2 0 0 8 


31. Using a Turtle object from the galapagos package, draw three rectangles. 
Accept the width and the length of the smallest rectangle from the user. The 
middle and the largest rectangles are 40 and 80 percent larger, respectively, 
than the smallest rectangle. The galapagos package and its documentation 
are available at the McGraw-Hill book website. 
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32. Develop a program that draws a bar chart using a Turtle object. Input five int 
values, and draw the vertical bars that represent the entered values in the 
following manner: 



Your Turtle must draw everything shown in the diagram, including the axes 
and numbers. 
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Defining Your Own 
Classes—Part 1 



Objectives 


After you have read and studied this chapter,you 
should be able to 

• Define a class with multiple methods and data 
members. 

• Differentiate the local and instance variables. 

• Define and use value-returning methods. 

• Distinguish private and public methods. 

• Distinguish private and public data members. 

• Pass both primitive data and objects to a 
method. 




. TV 


+t_ >■ F 
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Introduction 



o far we have been using only standard classes such as System, String, and others 
when we wrote programs. For a basic program, that is fine. However, we need to 
to learn how to write programs using our own classes (in addition to using the stan¬ 
dard classes) when the programs become large and complex. In this chapter, we 
learn the basics of how to define our own classes. And, in Chapter 7, we will cover 
more advanced topics on defining classes. 


4.1 


First Example: Defining and Using a Class 


The most economical and effective means of on-campus transportation is without 
doubt a bicycle. Suppose we want to develop a program that tracks the bicycles by 
assigning to them some form of identification number along with the relevant 
information, such as the owner’s name and phone number. To develop such a Java 
program, we need to design many different types of objects. For example, we need 
objects to handle input, output, data storage, and other computational tasks. Among 
the many types of objects necessary for this program, we will design one class here 
that models a bicycle. There’s no such Bicycle class among the standard classes, of 
course, so we need to define one ourselves. We will learn how to define the Bicycle 
class in this section. We will start with a very simplistic Bicycle class. Using this 
class, we can only assign and retrieve the owner’s name. Before we look inside the 
Bicycle class and explain how the class is defined, let’s first look at how we might 
use it in our program. The following sample program creates two Bicycle objects, 
assigns the owners’ names to them, and displays the information: 


► 
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1 1 e and assign values to bikel 


owns a bicycle."); 
al so owns a bi cycl e, 
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programmer- 
defined classes 


Here’s the definition of the Bicycle class. To distinguish it from the standard 
classes, we call the Bicycle and other classes we define programmer-defined classes. 


class Bicycle { 


II Data Member 

private String owne r Na me; 

//Constructor: Initialzes the data member 

publ i c Bicycle) ) { 

o wn e r Na me = "Unknown"; 

} 


//Returns the name of this bicycle's owner 

public String get Owner Namef ) { 
return ownerName; 

} 


//Assigns the name of this bicycle's owner 

public void setOwnerName ( Str i ng name) { 

o wn e r Na me = n a me: 

} 

} 


The dependency diagram between the two classes is as follows: 


BicycleRegistration 


Bicycle 


When this program is executed, we get the following output on the standard output 
window: 


Adam Smith owns a bicycle. 

Ben Jones also owns a bicycle, 

This main class should look very familiar to all of us. The key difference lies in 
the use of the Bicycle class instead of the standard classes we have been using so far. 
The way we use the Bicycle class is the same. For example, we create a Bicycle object 
bike2 by calling the new operator, and we assign the name of its owner by executing 

bi ke2 = new Bicycle) ); 

bi ke2. setOwnerName)" Ben Jones"); 
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To get the name of the owner of bike2, we write 
bi k e 2. get Owner N a me () 

And we can assign the returned value to a variable if we write 
St ri ng owner 2; 

owner 2 = bi ke2. getOwnerName () ; 

Although it is not a requirement, we will save one class definition per hie to keep 
things simple. For the hie name, we will use the name of the class followed by the 
java suffix. So, we save the Bicycle class in a hie named Bicycle.java. 



ings to Remember 

Save one class definition per file. Use the name of the class followed by the suffix 
java as the file name. Follow this rule to avoid any unnecessary complications. 


For this sample program, we have created two classes —BicycleRegistration (the 
main class) and Bicycle. So there are two source hies for this program. 


BicycleRegistration.java Bicycle.java 

The Bicycle Class 

Now let’s study the Bicycle class. Table 4.1 lists the three methods of the Bicycle 
class and their description. 

Flere’s a template for the Bicycle class declaration: 

class Bicycle { 

II data members 
/ / me t h o d s 




Table 4.1 The three methods of the B i c y c I e class. The first method is called 
a constructor 


Method 

Parameter 

Description 

Bicycle 

None 

Initializes the owner's name toUnassi gned. 

get Owner Na me 

None 

Returns the owner's name. 

s et Owner Na me 

Name of the 

Assigns the bicycle owner's name to the passed 


owner (string) 

value. 
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The class declaration begins with the reserved word class followed by the name. 
Any valid identifier that is not a reserved word can be used as the class name. 

We define the three methods inside the class declaration. But before we can 
provide the method definitions, we need to consider the data members of the Bicycle 
class. Remember, in Section 1.3, we stated that data members of a class are the data 
values associated with the class or instances of the class, such as the current balance 
of an Account object. What would be the data members of Bicycle objects? We need 
to know the owner’s name of every Bicycle object, so we’ll define one data member 
to store the owner’s name. The data members of a class are declared within the class 
declaration. Here’s how we define the data member ownerName of the Bicycle class: 

class Bicycle { 

private String ownerName; 

//definitions for the constructor, 

/ / ge t Own e r Na me, and setOwnerName methods come here 

} 

The ownerName data member is an instance variable (we will learn how to de¬ 
clare class constants later in this chapter and class variables in Chap. 7). Remember 
that, in Section 1.3, we defined an instance variable as the data member we associate 
to an individual instance and whose value can change over time. In other words, each 
instance of the class will have its own copy. After the two Bicycle objects are created 
and assigned their respective names by program, we have the following memory state: 


bikel bike2 



The syntax for the data member declaration is 

<modi fi er-l i st> < d a t a type> <name> ; 

where <modifier-list> designates different characteristics of the data member, <data 
type> the class name or primitive data type, and <name> the name of the data mem¬ 
ber. Here’s how the general syntax corresponds to the actual declaration: 


Modifier 



pr i vat e 


H 


Data Type 


r 1 


Name 


String ownerName ; 
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accessibility 

modifier 


void method 


In this example, the data member has one modifier named private. This modifier is 
called an ccessibility modifier, or a visibility modifier, and it restricts who can have 
a direct access to the data member. If the modifier is private, then only the methods 
defined in the class can access it directly. We will provide a more detailed discus¬ 
sion of the accessibility modifiers in Section 4.6. For now, it suffices to remember 
that data members are declared private for the most part. 

Now that the necessary data member is taken care of, we are ready to define the 
three methods. We start with the setOwnerName method, which is declared as 

public void setOwnerNamefStri ng name) { 
o wn e r Na me = n a me; 

} 

The syntax for defining a method, as given in Chapter 2, is 

<modifiers> <r et ur n t ype> <met hod name> ( <parameters> ) { 
<s t a t e me nt s > 


} 

The following diagram shows how the components in the general syntax cor¬ 
respond to the actual elements in the setOwnerName method: 


Return Type |— 
Modifier 


difier |—| 


H 


Method Name 


r 1 


Parameter 


publ i C void setOwnerName ( String name ) { 
] ownerName = name; !-1 Statements 


This refers to 
instance variable 

ownerName. 


This refers to 
parameter name. 


We explained in Chapter 1 that methods may or may not return a value. A 
method that does not return a value, such as this setOwnerName method, is declared 
as void. It is called a void mettle . The accessibility modifier for the setOwnerName 
method is declared as public. This means the program that uses the Bicycle class can 
access, or call, this method. It is possible (and could be useful) to declare a method 
as private. If a method is declared as private, then it cannot be called from the pro¬ 
gram that uses the class. It can only be called from the other methods of the same 
class. For now we will limit our discussion to public methods. Here we declare all 
methods as public because we want the programs that use the Bicycle class to be able 
to call them. We will go over the use of private methods later in the chapter. 
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value-returning 

method 


return state¬ 
ment syntax 


The getOwnerName method is defined as follows: 

public String getOwnerName) ) { 
return ownerName; 

} 

The following diagram shows how the components in the general syntax corre¬ 
spond to the actual elements in the getOwnerName method: 


Return Type |— 
Modifier |—| 


—| Method Name 

—| Parameter 

publ i C String getOwnerName ( 

) { 


[ return ownerName; j - 1 Statements 


} 

This refers to 
instance variable 

ownerName. 


This is a value-returning metho . When this method is called, it returns a 
value to the caller. The getOwnerName method returns a string value—the value of 
instance variable ownerName— so its return type is declared as String. A value¬ 
returning method must include a return statement of the format 

return <expression> ; 

The data type of <expression> must be compatible with the declared return 
type of the method. For example, if the return type is int, then the data type of the 
returned value must be compatible with int (data types int, short, and byte are all 
compatible with int). Data type compatibilites are explained in Section 3.2. 

If a method returns a value, then we can include a call to the method in an ex¬ 
pression itself. For example, instead of writing 

Bicycle bike; 

String owner = b i ke, getOwnerName ( ); 

System, out. pri ntl n(owner + "owns a bike."); 

we can write 

Bi cycl e bi ke; 

System, out. pri ntl n(bi ke. getOwnerName( ) + “owns a bike,"); 
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accessor 

mutator 


constructor 


A method that returns information about an object (such as who is the owner 
of a bicycle) is called an accessor. The getOwnerName method is an accessor. An 
inverse of an accessor that sets a property of an object is called a mutator. The 
setOwnerName method is a mutator. Accessors and mutators are commonly called 
get and set methods, respectively. 

A value-returning method can include more than one return statement. The 
use of multiple return statements make sense only in the context of the control 
statements, which we will discuss in Chapters 5 and 6. We will be seeing examples 
of multiple return statements in these chapters. 

The first method defined in the Bicycle class is a special method called a con¬ 
structor. A constructor is a special method that is executed when a new instance of 
the class is created, that is, when the new operator is called. Here’s the constructor 
for the Bicycle class: 

public Bi cycl e( ) { 

o wn e r Na me = "Unassi gned"; 

} 

It follows the general syntax 

public <c I ass name> ( <parameters> ) { 

<s t a t e me nt s > 

} 

where <class name> is the name of the class to which this constructor belongs. The 
following diagram shows how the components in the general syntax correspond to 
the actual elements in the constructor of the Bicycle class: 


Modifier 


h 


H 


Class Name 


r 1 


publ i C Bicycle ( 


Parameters 


) { 


! ownerName = "Unassigned 


H 


Statements 


Notice that a constructor does not have a return type and, consequently, will 
never include a return statement. The modifier of a constructor does not have to be 
public, but non-public constructors are rarely used. This example shows no parame¬ 
ters, but it is very common to define a constructor with two or three parameters. We 
will see an example of a constructor that accepts two parameters in Section 4.5. 
Until then, we will define only a zero-parameter constructor. 

The purpose of the Bicycle constructor is to initialize the data member to a 
value that reflects the state to which the real name is not yet assigned. Since a 
constructor is executed when a new instance is created, it is the most logical place 
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bike 

:> Bicycle bike; 


Bicycle bike; 

bike = new Bicycle( ); 


bike 



Bicycle bike; 

bike = new Bicycle( ) ; 

bike. setOwnerName( "Jon Java") ; 


bike 



s \ 



Figure 4.1 A sequence of state-of-memory diagrams that illustrate the effects of executing the constructor 
and the setOwnerName method of the Bicycle class. 


to initialize the data members and perform any other initialization tasks. Figure 4.1 
shows a sequence of state-of-memory diagrams illustrating the effects of executing 
the constructor and the setOwnerName method of the Bicycle class. 

We stated earlier that the Bicycle class has three methods, of which one is a 
constructor. However, a constructor is distinct from other “regular” methods, so it is 
more common to state that the Bicycle class has one constructor and two methods. 



ings to Remember 

Instead of saying “a class has three methods including one constructor/'it is more 
common to say "a class has one constructor and two methods." We will use the later 
expression in this book. 
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Bicycle 

ownerName - 1 Data Member Listing 

Bicycle() 

getOwnerName() | Method Listing 

setOwnerName( String) 

We include the data type 

- of an argument passed to 

the method. 


Figure 4.2 A class diagram of the Bicycle class with two methods and one data member. 


We will provide a more detailed discussion on constructors in Section 4.5. 
The class diagram that lists the data member, the constructor, and two meth¬ 
ods of the Bicycle class is shown in Figure 4.2. 

In listing the data members and methods of a class, we will use the following 
convention: 


class listing 
convention 


cl ass 

<class name> { 

// 

data members 

// 

constructor 

// 

methods 

} 



We list the data members first, then the constructor, and finally the methods. 
Within each group, we list elements in alphabetical order. Keep in mind that 
this convention for grouping elements and ordering them within a group is for our 
convenience. The Java compiler does not care how we list the data members and 
methods. 


Usings to Remember 

The Java compiler does not care how we order the methods and data members in 
the class declaration. We adopt the listing convention to make the class declaration 
easier for us to follow. 



Compiling and Running BicydeRegistration 

Up until now, when we ran the sample programs, we simply compiled and executed 
the main class. That’s all we need to do because the main class is the only class we 
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created for the sample programs. But for this sample program, we have created two 
classes— BicycleRegistration (the main class) and Bicycle. So there are two source 
files for this program. 


These files must 
be stored in the 
same folder. 


Source files for the BicycleRegistration program 


BicycleRegistration) ava 


Bicycle.java 


From now on, we will use the name of the main class to refer the whole pro¬ 
gram. To run the BicycleRegistration program, we must first compile the two source 
files and then run the main class. Here are the steps we follow to run this sample 
program (we will illustrate the steps using the minimalist approach, see App. A): 

1. Compile the Bicycle class. 

j avac Bicycle.java 

2. Compile the BicycleRegistration class. 

j avac Bi cycl eRegi st r ati on.j ava 

3. Run the BicycleRegistration class. 

java BicycleRegistration 

There is one last thing to remember. The way the classes are written now, the 
easiest way to manage a program that includes multiple programmer-defined 
classes is to save the source files in the same folder (directory). We will learn how 
to organize classes into a package in Chapter 7 so we can manage the organization 
of classes in a more effective manner. Until then, just remember to place all sources 
files for a program in the same folder. If you don’t do this, the Java compiler and 
interpreter may not be able to compile and run the program. 


ings to Remember 

Place all source files for a program in the same folder (directory). 


It is not necessary to create a separate folder for each program, though. In 
other words, one folder can contain source files for multiple programs. For example. 
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we could create one folder to place all source files for this chapter’s sample code. 
However, we recommend that students create a separate folder for each program¬ 
ming assignment or lab project for easy management. 


C[\ou 

D Might 
Want to 

Know 

The class declaration can be preceded with the accessibility modifier public or 
private. For now, we do not use any accessibility modifier for the class dec¬ 
laration. We will discuss the issue when we discuss a package organization in 

©/. 

# 

Chapter /. 



V 

1. Extend the Bicycle class by adding the second data member tagNo of type 
String. Declare this data member as private. 

2. Add a new method to the Bicycle class that assigns a tag number. This method 
will be called as follows: 

Bicycle bike; 
bike = new Bicycle) ) ; 

bi ke. setTagNol "2004-134R" ); 

3. Add a another method to the Bicycle class that returns the bicycle’s tag number. 
This method will be called as follows: 

Bicycle bike; 
bike = new Bicycle) ); 

String tag = bi ke.get TagNo) ); 


Quick 

C T 


4.2 Second Example: Defining and Using Multiple Classes 

Let’s write a second sample program to get more practice in defining classes. In 
this example, we will define a new class named Account. An Account object has 
the name of the owner (String) and the balance (double). We have two methods— 
add and deduct —to deposit to and withdraw money from the account. There are 
methods to set the initial balance and retrieve the current balance. These two 
methods are named setlnitialBalance and getCurrentBalance. Finally, we have 
an accessor and mutator for the account owner’s name— getOwnerName and 
setOwnerName. 
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The second sample program uses the Bicycle class from Section 4.1 and the 
Account class we define shortly in this section. Here’s the second sample program: 


class SecondMain { 

//This sample program uses both the Bicycle and Account classes 

public static void mai n(Stri ng[] args) { 

Bicycle bike; 

Account acct; 

String my N a me = "Jon java"; 

bike = new Bicycle! ); 
b i k e. set Own e r Na me ( my Na me ); 

acct = new Account ( ); 
acct. set Own e r Na me ( my Na me ) ; 
acct. setl ni ti al Bal a n c e ( 2 5 0. 00); 

acct. add(25.00); 
acct. deduct ( 50) ; 

//Output some i nf or mat i on 

Syst em. out. pr i nt I n( bi ke. get Owner Name! ) + " owns a bicycle and"); 
System, out. p r i n 11 n ( " has $ " + acct. getCurrentBal ance() + 

" left in the bank"); 


} 


} 


This program creates one Bicycle object and one Account object, sets their 
owner name to Jon Java, initializes the account balance to $250.00, adds $25.00 to 
the account, deducts $50.00 from the account, and finally prints out some informa¬ 
tion of bike and acct objects. The program diagram is as follows: 


SecondMain 


-7 


Bicycle 


-X 


Account 
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We are using the Bicycle class from Section 4.1 without modification, so we 
only have to consider defining the Account class. There are two data members for 
the class, one to store the owner’s name and another to maintain the account bal¬ 
ance. We have the following declaration for the two data members: 

class Account { 

private String ownerName; 

private double balance; 

//constructor and method declarations come here 


} 


The set and get methods for the owner’s name are identical to those defined 
for the Bicycle class. The add and deduct methods modifiy the balance by adding or 
deducting the passed amount. They are defined as follows: 


public void addfdoubl e amt) { 
balance = balance + amt; 

} 


public void deduct ( doubl e amt) { 
balance = balance - amt; 

} 


The setlnitialBalance and getCurrentBalance methods are similarly defined as the 
other set and get methods. Here’s the complete definition of the Account class: 


class Account { 

II Data Me mb e r s 

private String ownerName; 

private double balance; 

//Constructor 

public Account ( ) { 

owner Name = "Unassi gned"; 
balance = 0.0; 

} 

II Adds the passed amount to the balance 

public void add( doubl e amt) { 
balance = balance + amt; 

} 

//Deducts the passed amount from the balance 

public void deduct ( doubl e amt) { 
balance = balance - amt; 

} 
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Figure 4.3 shows a class diagram of the Account class. 

The second sample program is composed of three classes (we are not count¬ 
ing the standard classes). 



SecondMain Program 


We need to compile the three classes before we can run the program. However, we 
do not have to compile all three classes every time we want to run the program. For 
example, if the Bicycle class is already compiled and we are not making any changes 
to it, then there’s no need to compile the class again. (Note: We are assuming here 
that both programs are placed in the same directory. If the second program is in a 
separate folder, then you need to copy the bytecode hie Bicycle. class to this folder.) 

Notice the second call to the deduct method from the main method of 
SecondMain, which is 

acct.deduct ( 10) ; 

but the parameter for the deduct method is declared as type double. This call is valid 
because we are passing a value that is assignment-compatible to the double data 
type. We will elaborate on this topic in Section 4.3. 
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Account 

balance 

ownerName 

Account() 
add( double) 
deduct! double) 
getCurrentBalance() 
getOwnerName() 
setInitialBalance( double ) 
setOwnerNarae( String) 


Figure 4.3 A class diagram of the Account class with two data members, one constructor, and six methods. 


F— 

Quick 

CHECK 


1. What is the output from the following code fragment? 

Account acct; 
acct = new Account ( ) ; 
acct.setlniti al Bal ance(250); 
acct.add ( 20) ; 

System, out. printing' Balance: 11 

+ acct.getCurrentBalance(l); 

2. Write a code fragment to declare and create two Account objects named accl 
and acct2. Initialize the balance to $300 and $500, respectively. Set the name 
of owner for both accounts to John Doe. 


4.3 


Matching Arguments and Parameters 


Consider the following sample class that includes a method named compute. This 
method has three parameters—two int and one double. 


class De mo { 



public void compute) 

int i , 

int j , double 

/ / me t h o d body 



II the actual stat 

e me n t s 

in the body 

II are irrelevant 

to the 

di s c ussi on 


} 

} 
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argument 

parameter 


When we call the compute method, we must pass three values. The values we 
pass must be assignment-compatible with the corresponding parameters. For exam¬ 
ple, it is not okay to pass a double value to an int parameter. Here are some valid 
calls from the main method: 


class My Ma i n { 
public static 

Demo demo 
int i , k, 


void main(String[] 
= new Demo () ; 

m; 


arg) 


{ 


} 


i =12; 
k = 10; 
m = 14; 

d e mo. c o mp u t e ( 3, 
d e mo. c o mp u t e ( i , 
d e mo. c o mp u t e ( m, 


4, 5.5); 
k, m); 
20, 40); 


In the statement 

d e mo. c o mp u t e ( m, 20, 40); 


the values m. 20, and 40 are called arguments. An argument is a value we pass to a 
method, and the value is assigned to the corresponding parameters. A parameter 
is a placeholder in the called method to hold the value of a passed argument. The ar¬ 
guments and parameters are matched in left-to-right order. As long as the data 
type of an argument is assignment-compatible to the corresponding parameter, the 
call is valid. 

The identifier we use for an argument has no relation to the identifier used for 
the corresponding parameter. In the statement 

d e mo. c o mp u t e ( i , k, m); 


the fact that the same identifier i is used for both the first parameter and the first ar¬ 
gument has no significance. They are two distinct and separate variables, as shown 
in Figure 4.4. The figure also shows how the matching is done. 




ings to Remember 

A parameter receives the value of a corresponding argument. Because a 
parameter is like a placeholder that will not hold a value until an argument is 
passed to it, a parameter is called a formal parameter and an argument an 
actual parameter. 
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Demo demo = new Demo( ) ; 

i nt i = 5; 
i nt k = 14; 

demo. compute( i, k, 20 ); 



Passing side 


class Demo { ~ ~ ~ ^ 

public void compute(int i, i nt j, double x) { 


> 

> 


Receiving side 


Memory Allocation 



1- 


— i 


i S 


i 5 






i - 7*1 


— i 


k | 14 \ 


j | 3-4 | 

This is a literal 



~~ 


constant so it 


- 20 ' 


x |20.0 | 

has no name. 






Passing side Receiving side 


Figure 4.4 This diagram illustrates how the argument values are assigned, or passed, to the matching 
parameters. 


4.4 Passing Objects to a Method 

When calling the methods of the Bicycle and Account classes, we passed a numer¬ 
ical value or a String. In this section, we study how to pass an object when calling 
a method. Since a String is an object, in a sense, we actually know to pass an ob¬ 
ject as an argument to a method. However, a String is treated much as a primitive 
datum for the most part, so we will cover this topic using instances of our own 
class. 

First, we define the Student class. A Student object has a name (String) and an 
email (String). Here’s the definition: 



class Student { 


II Data Me mb e r s 

private String 

private string 


na me; 
e mai I ; 
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//Constructor 

public Student! ) { 

n a me = "Unassi gned"; 
e ma iI = "Unassi gned"; 


//Returns the email of this student 

public String g e t E ma i I ( ) { 

return e ma i I ; 

} 


Student 

name 

email 

Student/) 
getEmail/) 
getName/) 
setEmail/ String ) 
setName/ String) 


//Returns the name of this student 

public String get N a me ( ) { 

return n a me; 

} 

II Assigns the email of this student 
public void setEmai I (Stri ng address) { 

email = address; 

} 

//Assigns the name of this student 

public void setNa me (String st udent Name) { 

name = st udent Name; 

} 

} 


Then we define the LibraryCard class. A LibraryCard object is owned by a 
Student, and it records the number of books being checked out. Here’s the definition: 


class Li br ar yCar d { 

II Data Me mb e r s 

//student owner of this card 
private St udent owner; 

//number of books borrowed 

private i nt bor rowCnt; 

//Constructor 

public LibraryCard! ) { 
owner = null; 
bor r owCnt = 0; 


I 


LibraryCard 

owner 

borrowCnt 

LibraryCard/) 
checkout/ int ) 
getNumberOfBooks/) 
getOwnerName/) 
setOwner/ Student) 
toString/) 
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/ / nu mOf Books are checked out 

public void checkout ( i nt n u mOf Books) { 
borrowCnt = borrowCnt + numOfBooks; 

} 


//Returns the number of books borrowed 

public i nt ge t Nu mb er Of Boo ks ( ) { 
return borrowCnt; 

} 


//Returns the name of the owner of this card 

public String getOwnerName ( ) { 
return owner.getName ( ); 

} 

II Sets owner of this card to student 

public void set Owner ( Student student) { 
owner = student; 

} 

//Returns the string representation of this card 

public String t oSt ri ng( ) { 


return "Owner 

Na me: 

" + 

owner. getNamef ] 

1 + " \ n" + 

11 

E ma i 1 : 

■ + 

owner, get Emai 1 ( 

) + " \ n" + 

"Books 

Borrowed: 

" + 

bor r owCnt; 



Notice that we initialize the data member owner to null in the constructor. The value 
of null means that owner is pointing to no object. The setOwner method must be 
called to assign a Student object. The method accepts a Student object as its para¬ 
meter and sets the data member owner to this Student object. 

The getOwnerName method returns the name of the owner. It is defined as 

public String getOwnerName) ) { 
return owner.getName ( ); 

} 

Because the data member owner refers to a Student object, we can get the name of 
this student by calling its getName method. 

The toString method is a method that returns a string representation of an ob¬ 
ject. Because an object can have a nested structure (e.g., an object’s data member 
points to an instance of another class, the data members of this instance point to 
instances of other classes, and so forth), it is convenient for those who use the class 
to have a quick way to get printable information of an instance. Without such a 
toString method, the programmer who uses the class must write a code to fetch the 
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values of the data members individually. This can be quite tedious. With the 
toString method, she can display information of an instance by calling just one 
method toString. 

The power of being able to pass an object to a method comes in handy when 
we want multiple objects to share the same object. For example, suppose a single 
student owns two library cards (say, one for the general library and another for the 
engineering library). Then we can make the data member owner of two LibraryCard 
objects to refer to the same Student object. Here’s one such program: 


W 

class Librarian { 

public static void mai n(Stri ng[] args) { 

Student student; 

LibraryCard cardl, c a r d 2; 

student = new St udent ( ); 
student, set N a me ( "Jon java"); 
student. setEmai I ("jj @j avauni v. e d u" ) ; 

cardl = new LibraryCard) ); 
cardl. set Own er(student); 
cardl. checkout ( 3); 

c a r d 2 = new LibraryCard) ); 

card2. setOwner ( student ) ; //the same student is the owner 

II of the second card, too 

System, out. println)" Cardl Info:"); 

System, out. printlnfcardl. toString)) + " \ n " ) ; 

System, out. pri ntl n (" C a r d 2 I nfo: "); 

System, out. println(card2. toString)) + " \ n " ) ; 

} 

} 


In this program, we create one Student object. Then we create two LibraryCard 
objects. For each of these LibraryCard objects, we pass the same student when call¬ 
ing their setOwner methods: 

cardl. set Own er(student); 
c a r d 2. set Own er(student); 

After the setOwner method of card2 is called in the main method, we have the 
state of memory as shown in Figure 4.5. 
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cardl 


card2 



Figure 4.5 The state where the data members of two objects (of LibraryCard) are pointing to the same 
object (of Student). 


It is critical to realize that when we say pass an object to a method, we are not 
sending a copy of an object, but rather a reference to the object. Figure 4.6 shows 
how the passing of an object is done. 



hinqs to Remember 


When we pass an object to a method, we are actually passing the address, 
or reference, of an object to the method. 


jMjTlWW It is possible to return the Student object itself by defining the following method: 

■mAMM public Student get Owner ( ) { 

return owner; 

We will discuss such a method that returns an instance of a programmer-defined 
class in Chapter 7. 
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LibraryCard card2; 

card2 = new LibraryCard( ) ; 


card2. setOwner( student) ; 

- x - 


Passing side 


class LibraryCard { 

public void setOwner( Student student) { 
owner = student; (J) 


Receiving side 


Memory Allocation 


student 


student 


For an object, the 
content of a 
variable is an 
address, and this 
address is passed 
to the method. 


“Jon Java” 


email 


“jj @javauniv.edu” 


borrowCnt 


0 


card2 



Figure 4.6 This diagram illustrates how an object is passed as an argument to a method. 


4.5 Constructors 

We provide more detailed coverage of the constructors in this section. The con¬ 
structors we have defined so far accept no arguments. These constructors set the 
data members to some initial values. For example, the constructor for the Bicycle 
class in Section 4.1 initializes the value of owner (String) to Unassigned. For this 
particular Bicycle class, such a simplistic constructor is adequate. However, most 
cases require the constructors that accept one or more arguments. In fact, the way 
we defined the constructor for the Account class in Section 4.2 could lead to poten¬ 
tial problems. In this section, we describe the use of constructors that accept one 
or more arguments, and we show how this solves the potential problems of the 
Account class. 

Let’s begin by reviewing the Account class from Section 4.2. We will identify 
some potential problems and present a new constructor as a solution to rectify them. 
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Consider the following code: 

Account acct; 

acct = new Account! ); 

acct. setl ni ti al Bal a n c e ( 5 0 0 ) ; 
acct. setl ni ti al Bal a n c e ( 3 0 0 ) ; 

What is the effect of such code? It is logically inconsistent to initialize the starting 
balance more than once. It should be called exactly one, but there is no such Java 
language feature that puts constraints on the number of times the setlnitialBalance 
method can be called. The existence of this method is a problem, and we can remove 
it from the Account class by defining a constructor that sets the initial balance to a 
specified amount. 

Now consider the following code: 

Account acct; 

acct = new Account! ); 

acct. add! 2 0 0. 0 0 ) ; 

If an account can have the initial balance of zero, this code is acceptable. But if there 
is a rule that says, for example, an account must have the initial balance of $25 or more, 
then the setlnitialBalance method must be called first to initialize the balance to 25.00 
or more before any transactions (add or deduct) take place. This problem can also be 
solved by the same constructor that sets the initial balance to a specified amount. 
Here’s a new constructor that eliminates the two problems in one stroke: 

public Account ( do ub Ie starti ngBal ance) { 

own e r Na me = "Unassi gned"; 
balance = starti ngBal ance; 

} 

Once this constructor is defined, there is no longer a need for the setlnitialBalance 
method, so we can safely remove it from the class defintion. Only the add and 
deduct methods affect the balance after an object is created. 

After the old constructor is replaced by this new constructor, we must create 
an instance by passing one argument when calling the new operator. For example, 
the code 


Account acct; 

acct = new Account(500.00); 

will create a new Account object with its starting balance set to $500. We can no 
longer create an instance by writing 

Account acct; 

acct = new Account! ); 

because there is no matching constructor anymore. 
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Instead of this one-parameter constructor, we can define a constructor that 
accepts the name of the owner also, so that it, too, can be initialized at the time of 
object creation. Here’s how we define the two-parameter constructor: 

public Account(String name, double starti ngBal ance) { 

o wn e r Na me = n a me; 
balance = starti ngBal ance; 

} 

This is the constructor we will include in the modified Account class. With this two- 
parameter constructor, here’s how we create an Account object: 

Account acct; 

acct = new Account! "John Smith", 500.00); 

Notice that, even with this new constructor, we will keep the setOwnerName 
method in the class because we want to be able to change the name of the owner 
after the account is created. 

From the three different constructors possible for the Account class, we have 
selected the two-parameter constructor to include in the class. Actually, it is possi¬ 
ble to include all three constructors in the definition of the Account class. But until 
we learn how to define multiple constructors in Chapter 7, we will define exactly 
one constructor for our programmer-defined classes. 



It is possible to define more than one constructor to a class. Multiple contructors 
are called overloaded constructors. It is almost always a good idea to define multi¬ 
ple constructors to a class. But to keep things simple, we will manage with one 
constructor per class until Chapter 7. 


We are now ready to list the complete definition. Here’s the second version of 
the Account class (for the actual class name we will use AccountVer2 to avoid con¬ 
fusion when discussing different versions of the class definition): 


class AccountVer 2 { 

II Data Members 
private String ownerName; 

private double balance; 

//Constructor 

public AccountVer2(String name, double starti ngBal ance) { 
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owner Name = name; 
balance = starti ngBal ance; 

} 

//Adds the passed amount to the balance 

public void add( doubl e amt) { 
balance = balance + amt; 

} 

//Deducts the passed amount from the balance 

public void deduct ( doubl e amt) { 
balance = balance - amt; 

} 

//Returns the current balance of this account 

public double getCurrentBaI ance ( ) { 
return balance; 

} 

//Returns the name of this account's owner 

public String getOwnerName ( ) { 

return ownerName; 

} 

//Assigns the name of this account's owner 

public void s e t Own e r Na me ( S t r i n g name) { 

ownerName = name; 

} 

} 


Default Constructor 

As a design guideline, we strongly recommend to include constructors to 
programmer-defined classes, as we have been doing from the beginning of the 
chapter. However, it is not a requirement to define a constructor explicitly in a 
class. If no constructor is defined for a class, then the Java compiler will auto- 
default matically include a default constructor. A default constructor is a constructor that 

constructor accepts no arguments and has no statements in its body. For example, if we omit 

a constructor from the Bicycle class, a default constructor 

publ i c Bicycle! ) { 

} 

will be added to the class by the compiler to ensure its instances can be created. 

Even though a default constructor is automatically added by the compiler, we 
should never rely on it. We should always define our own constructor so that we can 
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initialize the data members properly and carry out any other initialization tasks. 
This ensures an object is created in a valid state (such as setting the balance of an 
account to more than the minimum). 



Always define a constructor and initialize data members fully in the 
constructor so an object will be created in a valid state. 



Once we define our own constructor, no default constructor is added. This means 
that once the constructor, such as 

public Account(String name, double starti ngBal ance ) { 

owner Name = name; 
balance = starti ngBal ance; 

} 

is added to the Account class, we will no longer be able to create a Account object 
anymore by executing 

Account acct; 

acct = new Account! ); 

because no matching constructor can be found in the class. 


Jjinqs to Remember 

Once a programmer has added an explicitly defined constructor to a class, no 
default constructor will be added to the class by the compiler. 



Let’s define another class for practice. We learned in a chemistry class that an 
element is the simplest type of matter that consists of exactly one kind of atom. These 
elements have unique physical and chemical properties. The elements are classified 
into groups and periods in the periodic table. Each element is represented by its 

1. name (e. g., hydrogen, helium, lithium, etc.); 

2. atomic number (e.g., 1, 2, 3, etc.); 

3. atomic symbol (e.g., H, He, Li, etc.); 

4. atomic mass (e.g., 1.008, 4.003, 6.941, etc.); 
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5. period (it ranges from 1 to 7); 

6. group (it ranges from 1 to 18 under the new system). 

We name the class Element. The class has one constructor and six accessors (get 
methods) for the six attributes. We do not have any mutators (set methods) for this 
class because once an Element object is created we will never change the values of 
its attributes. Because all of its attributes must be specified, the constructor has six 
parameters. Here’s the Element class: 


cl ass EI e me nt { 

II Data Me mb e r s 

pr i vat e S t r i n g n a me; 

pr i vat e i nt number; 

pr i vat e String symbol; 
pr i vat e d o u b I e ma s s; 
pr i vat e i n t period; 

pr i vat e i n t group; 


//Constructor 

publ ic Element (String elementName, int el ementNumber, 

String elementSymbol, doubl e el ement Mas s, 
int elementPeriod, int el ementGroup) { 


} 


n a me = e I e me n t N a me; 
number = el ementNumber; 
symbol = elementSymbol; 
ma s s = e I e me nt Ma s s; 
period = elementPeriod; 
group = el ementGroup; 


//Returns the element's name 

publ ic String getName () { 

return n a me; 

} 

//Returns the element's atomic number 
publ i c i nt get Number () { 
return number; 

} 


//Returns the element's 1- or 2-letter symbol 
public String getSymbol () { 
return s y mbo I ; 

} 


www.it-ebooks.info 



4.5 Constructors 179 


//Returns the element's atomic mass 

public double get Mass () { 
return ma s s; 

} 

//Returns the element's period 

public int getPerlod () { 
return period; 

} 

//Returns the element's group 

public int getGroup () { 
return group; 

} 


The following sample code creates three Element objects: 

Element el, e2, e3; 

el = new Element ("Hydrogen", 1, " H", 1.008, 1, 1); 
e2 = new Element ("Gold", 79, " A u ", 197.0, 6, 11); 
e3 = new Element ("Oxygen", 8, "0", 16.0, 2, 16); 

We will introduce sample programs that use the Element class later in the book. 


W 

Quick 

CHECK 


1. Which of the following constructors are invalid? 

public int Cl a s s A ( i n t one) { 

} 

public Cl a s s B ( i n t one, int two) { 

} 

void Cl assC( ) { 

} 

2. What is the main purpose of a constructor? 
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3. Complete the following constructor. 

class Test { 

private double score; 

public Test(double val) { 

//assign the value of para me ter to 
II the data member 

} 

} 


client 

programmers 


information 

hiding 

encapsulation 


4.6 


Information Hiding and Visibility Modifiers 


The modifiers public and private designate the accessibility, or visibility, of data 
members and methods. Although it is valid in Java, we do not recommend that 
programmers, especially beginners, leave out the visibility modifier in declaring 
data members and methods. From the object-oriented design standpoint, we rec¬ 
ommend that you always designate the data members and methods as private or 
public. We explain how to use these modifiers in this section. But before we get 
into the details, we first discuss the object-oriented design philosophy behind these 
modifiers. 

Consider a mobile robot as an example. What kind of behavior do we expect 
from a mobile robot? Behaviors such as moving forward, turning, stopping, and 
changing speed come to mind easily. When we define a class, say, MobileRobot, we 
will include public methods such as move, turn, stop, and changeSpeed. These 
methods are declared public so the programmers who use a MobileRobot object can 
call these methods from their programs. We call these programmers client program¬ 
mers and their programs client programs. 

Now let’s assume that the move method accepts an integer argument as a dis¬ 
tance to travel in meters. Suppose this mobile robot has three wheels with a motor 
attached to each of the left and right rear wheels. The robot has no steering mecha¬ 
nism, so the turning is done by rotating the left and right rear wheels at different 
speeds. For example, by rotating the left wheel faster than the right wheel, the robot 
will make a gradual left turn. To move forward, the robot must send the same 
amount of power to the two motors. While the motors are rotating, the robot must 
constantly monitor the distance traveled and stop the motors when the designated 
distance is traveled. 

The MobileRobot class includes methods such as rotate to rotate the motor 
and readDistance to read the distance traveled. These methods are declared private 
because they are internal details that need to be hidden from the client program¬ 
mers. From our perspective as a client programmer, all we care is that the mobile 
robot exhibits the behavior of moving the desired distance when we call its move 
method. We do not care what’s going on inside. This is called information hiding. It 
is not our concern how many motors the robot has or what type of mechanism is 
employed to move the robot. We say the mobile robot encapsulates the internal 
workings. 
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This encapsulation mechanism allows easier modification of program code. 
For example, suppose the motion mechanism of a mobile robot is modified to a sin¬ 
gle motor and rack-and-pinion steering. Both wheels are now connected to a single 
axle, and the motor turns this axle (via gears). The internal mechanism has changed, 
but this will not affect the client programs. Calling the move method still exhibits 
the same behavior. 

To implement its methods (both public and private), the MobileRobot class 
will necessarily include many data members, such as current speed, current direc¬ 
tion, power levels of the motors, and so forth. These data members are internal de¬ 
tails of the class because it is not a concern of the client programmers to know 
which and how many of them are defined in the class. As such, data members are 
declared as private. 

In summary, behavior of the instances is implemented by public methods, 
while the internal details that must be hidden from the client programmers are im¬ 
plemented by private methods and private data members. 



Public methods of a class determine the behavior of its instances. Internal 
details are implemented by private methods and private data members. 


Now let’s go through a concrete example to see what would happen if some¬ 
thing that should be an internal detail is declared public. To illustrate why declaring 
data members public is considered a bad design, let’s consider the AccountVer2 
class. Suppose its data member balance is declared as public: 

class AccountVer 2 { 

public double balance; 

II the rest is the same 

} 



Moving a mobile robot forward in reality is actually a far more difficult task than 
described in the text. First, applying the same power to the two motors does not 
guarantee the straight movement due to the difference in the motor characteris¬ 
tics and the floor condition. Second, the robot needs to carry out some form of ob¬ 
stacle avoidance, using a device such as a sonar or infrared sensor, because we 
normally do not want a robot to crash into a wall.Third, stopping is not achieved 
by abruptly shutting off the power to the motors. This will make the stopping 
too sudden. We want to gradually reduce the power level so the robot comes to 
a smooth stop. And there are other complexities involved in actually moving a 
physical robot. 
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If this were the class definition, we could not prohibit client programmers 
from writing code such as 

AccountVer2 myAcct; 

myAcct = new AccountVer2( "J ohn Smith", 300.00); 

myAcct,balance = 670.00; 

This breaks the AccountVer2 class because the balance can be modified directly 
by the client programmers. The purpose of removing the setlnitialBalance method is 
defeated because the client programmers will have direct access to the data member 
balance. They can change its value as they wish. If the instance variable balance is 
properly hidden by declaring it private, then the client programmers cannot modify its 
value directly. They can update the value indirectly only via the add and deduct meth¬ 
ods. This maintains the integrity of the class, because the values of the data members 
are changed only via the public methods the class designer provides. The client pro¬ 
grammers cannot access or modify the data members through the back door. 



To distingush the private and public components of a class in the program di¬ 
agram, we use the plus symbol (+) forpublic and the minus symbol (—) for private. 
Using these symbols, the diagram that shows both data members and methods for 
the AccountVer2 class becomes 


AccountVer2 

— balance 

— ownerName 

+ AccountVer2( String, double ) 
+ add( double) 

+ deduct( double) 

+ getCurrentBalance() 

+ getOwnerName() 

+ setOwnerName( String ) 


P 


Quick 


CHECK 

V 


1. If the data member speed is private, is the following statement valid in a client 
program? 

Robot ai bo; 

ai bo = new Robot () ; 

double currentSpeed = aibo.speed; 
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2. Suppose you wrote down important information, such as your bank account 
number, student registration ID, and so forth, on a single sheet of paper. Will 
this sheet be declared private and kept in your desk drawer, or public and 
posted on the dorm’s front door? 

3. Identify the private methods from the following diagram. 


MyClass 

— mydata : double 
+ MyClass() 

+ methodOne(double) : void 

— methodTwo(double) : double 

— methodThree(double) : double 


4.7 Class Constants 

We introduced the use of the reserved word final in declaring constants in Section 3.3. 
The constants we declared there were used by only one method—the main method. 
In this section we will show how a class constant is declared. A class constant will 
be shared by all methods of the class. 

Let’s define another version of the Account class (the actual name will be 
AccountVer3). This time we will charge a fixed fee whenever a deduction is made. 
Here’s how the class is declared (we will not list the unchanged methods here): 
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Fee is charged 
every time 
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//other methods are exactly the same as before, so 
II we wi I I o mi t t h e m h e r e 


} 



The following sample program shows that the fee of $1.50 is charged after 
three deductions. 


import java,text.*; 

class DeductionWithFee { 

//This sample program deducts money three times 
//from the account 

public static void mai n(Stri ng[] args) { 

Dec i ma I Format df = new Dec i mai For mat (" 0.0 0" ); 


AccountVer 3 acct; 


acct = new AccountVer3("Carl Smith", 50.00); 


} 



acct,deduct ( 10); 
acct.deduct ( 10); 
acct.deduct ( 10); 

System, out. pri ntl n(" Owner 
System, out. pri ntl n("Bal 


} 


" + ac ct. get Owner Name ( )) ; 

$" 

+ df. format(acct. getCurrentBal a n c e ())); 


This is the output we get when we run the program: 

Own e r : Carl S mi t h 
Bal : $18.50 

Notice the use of a DecimalFormat object to display the result to two decimal places. 
Here is the dependency relationship diagram (standard classes are not included) 
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and the source files for the program are 



DeductionWithFee.java Account Ver3 .java 

The class constant FEE is declared as 

private static final double FEE = 0.50; 

The modifier final designates that the identifier FEE is a constant, and the modifier 
static designates that it is a class constant. The reserved word static is used to de¬ 
clare class components, such as class variables and class methods. The inclusion of 
the reserved word static in the declaration of the main method indicates that it is a 
class method. It is not so frequent that we use class variables and class methods 
(except, of course, the main method), and we will not be seeing their examples until 
later in the book. 

Before we move to another example, consider the following (problematic) 
declaration: 

class AccountVer 3 { 

private final double FEE = 0.50; 

is / / ® Ire rest is the s a me 

} 

This declaration is not an error, but it is inefficient. If FEE is declared as a class con¬ 
stant, then there will be one copy for the class, and this single copy is shared by all in¬ 
stances of the class. If FEE is declared without the static modifier, then it is an instance 
constant. This means every instance of the class will have its own copy of the same 
value. For example, instead of one copy of the value 0.50, there will be 100 copies of 
the same value 0.50 if there are 100 instances of the class. So, to make effective use 
of a memory, when we declare a data member as a constant, it should be declared as 
a class constant. This problem was introduced in Chapter 1, and Figure 1.9 illustrates 
the problem. 


ings to Remember 

If a data member is a constant, declare it as a class constant. 
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Let’s try another sample program. This time we will write a class that models 
a die. Notice how the constants are used in the following Die class: 


import java.util.Random; 

class Die { 

II Data Me mb e r s 

II the largest number on a die 

private static final int MA X_ NUMBER = 6; 

II the smallest number on a die 

private static final i nt Ml N_NUMBER = 1; 

//To represent a die that is not yet rolled 

private static final int N0_NUMBER = 0; 

private int number; 
private Random random; 

//Constructor 

public Diet) { 

random = new Random!); 

number = NO NUMBER; 

} 

//Rolls the die 

public void r oI I ( ) { 

number = r andom. next I nt (MAX NUMBER - MIN NUMBER + 1) + MIN NUMBER; 

} 

//Returns the number on this die 

public int get N u mb e r ( ) { 
return number; 

} 


We use the instance variable number to store the value of a die after it is rolled. 
Inside the constructor, we initialize number to the constant NO_NUMBER to repre¬ 
sent the state before the die is rolled. The roll method uses the formula for random 
number generation described in Chapter 3. The minimum and the maximum 
numbers on a die are kept as the class constants. By changing their values, our soft¬ 
ware die can be made to represent any range of values, not just 1 to 6. {Note: Yes, 
we can change their values when we edit the class. A Java constant only means 
that we cannot change its value while the program is running.) 
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Here’s a program that uses three Die objects to simulate a roll of three dice: 


class Rol I Di c e { 

//Simulates the rolling of three dice 

public static void mai n(Stri ng[] args) { 

Die one, two, three; 

one = new Di e ( ); 
two = new Di e ( ); 
three = new Diet ); 

one. r olI ( ); 
t wo. r o I I ( ); 
t hr ee. r ol I ( ); 

System, out. printlnf" Results are " + one. get Number ( ) + " " + 

t wo. get Number ( ) + " " + 
three, getNumb er( ) ); 

} 

} 



The dependency diagram and a sample output are as follows: 



Results are 3 6 5 


The output of this program is rather primitive, but it still conveys the neces¬ 
sary information. We will learn some drawing techniques in Chapter 5, so we can 
really draw the image of three dice. 

Let’s adapt the implemention of the Die class to write another program. 
Here’s the scenario for our next program. Getting a single-occupancy room in a 
dormitory is very tough because of high demand. There’s one especially large and 
comfortable single-occupancy room in your dorm that everybody covets. The 
housing office runs a lottery at the beginning of a quarter. Students must submit 
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their entries before the lottery (if there’s no winner, then the room will be auc¬ 
tioned off at eBay). The result of the lottery will consist of three cards. The num¬ 
bers on a card range from 10 to 15, and the color of a card can be red, green, or 
blue. Here are some possible outcomes: 



We will write a program that will select a winning combination of lottery 
cards. Following the implementation style of the Die class, we will define a class 
that models the lottery card. There will be two instance variables, one for color and 
another for the number. We will use a random number generator to select a color and 
a number for each lottery card. To represent a color, we will use a simple coding: 
1 for red, 2 for green, and 3 for blue. 

Here’s the LotteryCard class: 


import java.util.Random; 
class LotteryCard { 

II Data Me mb e r s 

II the largest number on a card 

private static final i nt MAX_NUMBER = 15; 

II the smallest number on a card 

private static final i nt Ml N_NUMBER = 10; 

II to represent a card before drawing 

private static final int N0_NUMBER = 0; 

II the 'largest' color for a card 

private static final i nt MAX_COLOR = 3; 

II the 'smallest' color for a card 

private static final i nt Ml N_C0L0R = 1; 

II to represent a card before drawing 

private static final i nt N0C0L0R = 0; 

//selected number on this card 

private int number; 

II selected color of this card 

private int color; 
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//random number generator 
private Random random; 

//Constructor 

public Lot t er yCar d ( ) { 

random = new Random) ); 
number = NO NUMBER; 
color = NO COLOR; 

} 

II spin the card 

public void spin) ) { 

number = random, nextl nt(MAX_NUMBER - Ml N_NUMBER + 1) + Ml N_NUMBER; 
color = r andom, next I nt ( MAX COLOR - MIN COLOR + 1) + MIN COLOR; 

} 

//Returns the number on this card 

public int get Number ( ) { 
return number; 

} 

//Returns the color of this card 

public int get Col or ( ) { 
return color; 

} 


And here’s the main class that draws the winning card combination: 


W 

class RoomWinner { 

//Simulates the rolling of three dice 

public static void main(String[] args) { 

LotteryCard one, two, three; 

one = new Lot t er yCar d( ) ; 

t wo = new Lot t er yCar d( ) ; 

three = new Lot t eryCar d( ) ; 

one. spl n() ; 
t wo. s p I n () ; 
t h r ee. s p i n () ; 

System, out. println)" Winning Card Combination: "); 
System, out. pri ntl n("l - red; 2 - green; 3 - blue"); 
S y s t e m. o u t. p r i n 11 n ( 11 " ) ; 
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System, out. pr i 
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The dependency diagram is as follows: 



When this program is executed, output similar to the following is displayed: 


Winning Card Combination: 

1- red; 2 - green; 3- blue 




Col or 

number 

Car d 

1: 

2 

13 

Car d 

2: 

2 

12 

Car d 

3: 

1 

14 


Again, the output is rather primitive. We will learn some drawing techniques in 
Chapter 5 so we can draw the image of a card in the appropriate color. 

Public Constants 

We stated in Section 4.6 that data members should be declared private to ensure the 
integrity of a class. Following this guideline, we declared the class constant data 
members in both sample programs as private. But there is an exception. We may 
want to declare certain types of class constants as public. Here are the reasons for 
this exception. First, a constant is “read only” by its nature, so it won’t have a neg¬ 
ative impact if we declare it as public. Second, a constant is a clean way to make 
certain characteristics of the instances known to the client programs. 
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For example, if we want to make the amount of a fee public knowledge 
(which is a good idea, because consumers need to know such information), we 
make the class constant public as follows: 

class AccountVer 3 { 

public static final double FEE = 0.50; 

} 

A client program can then access this information directly as 

System, out. printlnf" Fee charged per deduction is $ " 

+ AccountVer3. FEE); 

Notice that the class data members are accessed by the syntax 

<c I ass name> . <c I ass data member s> 

The use of public class constants is quite common in Java, and we will be seeing 
many examples of it in the later sample programs. 


Quick 

CHECK 

V 


1. Declare two class constants named MIN_BALANCE and MAX_BALANCE whose 
data types are double. 

2. Is there any problem with the following declarations? 

class Quest ion { 

private final int MAX = 20; 


} 

3. Modify the Die class so its instances will generate a number between 5 and 15, 
inclusively. 


4.8 Local Variables 

We often need to use temporary variables while completing a task in a method. 
Consider the deduct method of the Account class: 

public void deduct ( doubl e amt) { 

balance = balance - amt; 

} 


We can rewrite the method, using a local variable, as follows: 
public void deduct ( doubl e amt) { 
double n e wB a I ance; 


This is a local 
variable 
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newBalance = balance - amt; 
balance = newBalance; 

} 

local variable The variable newBalance is called a local variable. They are declared within 

the method declaration and used for temporary purposes, such as storing intermedi¬ 
ate results of a computation. 

Such two-step assignment to update the current balance may not seem so use¬ 
ful here, but consider a situation in which we need to check for certain conditions 
before actually changing the value of currentBalance. For example, we may want to 
disallow the purchase if the balance goes below a preset minimum balance. So if 
newBalance becomes lower than the set minimum, then we’ll leave balance un¬ 
changed. If we don’t use any local variable, then we have to deduct the amount from 
balance (temporarily) and change it back to the previous amount. Use of a tempo¬ 
rary local variable will result in a much cleaner code. We will see how such check¬ 
ing is done in Chapter 5 using a selection statement. 

The methods in the sample classes from this chapter are still very short, so the 
use of local variables may not be clear-cut. However, we will witness an increase in the 
use of local variables in the coming chapters when the methods become complex. 

While the data members of a class are accessible from all instance methods of 
the class, local variables and parameters are accessible only from the method in which 
they are declared, and they are available only while the method is being executed. 
Memory space for local variables and parameters is allocated upon declaration and at 
the beginning of the method, respectively, and erased upon exiting from the method. 


K9H 

IjjM Local variables and parameters are erased when the execution of a method is 
completed. 


When you declare a local variable, make sure the identifier you use for it does 
not conflict with the data members of a class. Consider the following hypothetical 
class declaration: 



class Sampl e { 



private int number; 



public void doSo me thing! 

) { 

This changes the value 
of the local variable, not 
the instance variable. 

i nt number ; 

number = 15; 

} 

The same identifier is used for both the 
local variable and the instance variable. 


} 
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This class declaration is not an error. It is acceptable to use the same identifier for a 
local variable, but it is not advisable. The following association rules are used: 


IThings to Remember 



Rules for associating an identifier to a local variable, a parameter, and a data 
member: 

1. if there's a matching local variable declaration or a parameter, then the 
identifier refers to the local variable or the parameter. 

2. Otherwise, if there's a matching data member declaration, then the identifier 
refers to the data member. 

3. Otherwise, it is an error because there's no matching declaration. 


So the assignment 

n u mb e r = 15; 

will change the value of the local variable. This may or may not be the intent 
of the programmer. Even if this is the programmer’s intention, it is cleaner and 
easier to read, especially to other programmers, to use different identifiers for local 
variables. 


IThings to Remember 



Avoid using the same identifier for the local variables and the data members of a 
class. 


W 

1. How is a local variable different from an instance variable? 

2. Rewrite the following method, using local variables. 

public int total Chargefi nt amt) { 

return (balance - 

(int) Math. round(amt * 1.5)); 

} 

4.9 Calling Methods of the Same Class 

Up until now, whenever we called a method of some object, we used dot notation, 
such as acct.deduct(12). Just as we can call a method of another object, it is possible to 


Quick 

CHECK 
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:AClass 


publ i C VOI d myMethod() { 

BClass obj 

= new BClassf) ; 


obj. doWork( ) ; 



Dot notation is necessary 
when you are calling a 
method of another object. 


:BClass 


publ i c voi d doWork() { 

} 

publ i C voi d myMethod( ) { 
doWork() ; 


Dot notation is optional 
when you are calling a 
method of the same object. 


Figure 4.7 The difference between calling a method belonging to the same object and a method belonging 
to a different object. 


call a method from a method of the same object. Figure 4.7 illustrates the difference 
between calling another method of the same object and calling a method of a dif¬ 
ferent object. 

Let’s look at a few examples. In the first example, we modify the AccountVer3 
class so the add and deduct methods call the private method adjust. Here’s how the 
modified class is declared (the actual class name is AccountVer4, and only the rele¬ 
vant portion is listed here): 


class AccountVer4 { 


II Adds the passed amount to the balance 

public void add( doubl e amt) { 
a d j u s t ( a mt ); 

} 

//Deducts the passed amount from the balance 

public void deduct ( doubl e amt) { 
adjust) - ( a mt + F E E ) ); 

} 


//Adjusts the account balance 

private void adjustfdouble adjustAmt) { 
balance = balance + adjustAmt; 

} 
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The add and deduct methods differ only in whether you add to or subtract the 
amount from the balance. In the modified class, we redefine the two methods so 
they call the common private method adjust. This method adds the passed amount 
to the balance (in the case for the deduct method, we pass the negative amount be¬ 
cause adding a negative value — X is equivalent to subtracting a positive value X). 
Here’s how the add method is defined: 

public void add( doubl e amt) { 
a d j u s t ( a mt ); 

^ Notice there is no dot notation.This is calling another method that belongs 

to the same class. 


When we call a method that belongs to the same class, we just include the method 
name, as follows: 

a d j u s t ( a mt ) ; 

No dot notation is necessary. 


bings to Remember 


No dot notation is necessary when you call a method from another method of the 
same class. 



Let’s look at the second example. In the original Die class, when a new in¬ 
stance was created, we set its number to NO_NUMBER. This means if a programmer 
calls the getNumber method of a Die object before calling its roll method, she will 
get NO_NUMBER as a result. For a real die, there’s no such NO^NUMBER state, so 
instead of instantiating a new Die object in such a state, we’ll redefine the class so a 
die gets rolled when it is first created. The trick here is to call the roll method from 
the constructor. Here’s how the modified Die class is declared (the class name is 
DieVer2): 


import java.util.Random; 
class D i e V e r 2 { 

II Data Me mbe r s 

II the largest number on a die 

private static final i nt MAX _ N U M B E R = 6; 
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II the smallest number on a die 

private static final i nt Ml N_NUMBER = 1; 

private int number; 
private Random random; 

//Constructor 

public Di eVer 2 ( ) { 

random = new Random) ) ; 

rolI (); 

} 

//Rolls the die 

public void roll) ) { 

number = r andom. next I nt ( MAX NUMBER - MIN NUMBER + 1) + MIN NUMBER; 

} 


//Returns the number on this die 

public int get Number ( ) { 
return number; 

} 


The constructor simply calls the roll method. So when a new Die object is cre¬ 
ated, a number is already preselected. Notice that it is possible to declare the 
constructor as 

public Di eVer 2( ) { 

random = new Random) ); 

number = random, nextl nt) MA X_ NUMBER - Ml N_NUMBER + 1) 

+ Ml N NUMBER; 

} 

But this ends up duplicating the same code. Instead of repeating the same code in 
the class, it is much better organizationally to define a single method and call this 
method from multiple places. Duplication of code, in general, makes the modifica¬ 
tion of code tedious and error-prone. Imagine the situation in which the same code 
is repeated at 10 different locations. It is so easy to miss one or two of them at the 
modification time. 


hings to Remember 


Avoid duplicating the same code. Duplication of code often means tedious and 
error-prone activities when you modify the code. 
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w 

Quick 

CHECK 


1. Suppose a class Alpha includes a method called compute that accepts no 
arguments. Define another method of Alpha named myMethod that calls the 
compute method. 

2. Why should duplication of code be avoided? 


4.10 Changing Any Class to a Main Class 

In this section, we will show you a simple way to make any class (such as Bicycle) 
also the main class of a program. Instead of defining a separate main class, as we 
have done so far, it is possible to define the main method to a class so the class be¬ 
comes the main class of a program also. There are a number of advantages in doing 
this. First, we have one less class to manage if we don’t have to define a separate 
main class. This advantage may not be seem so substantial. However, when we 
write numerous classes (e.g., writing solutions to the chapter exercises), writing a 
separate main class for all those classes so they become executable becomes te¬ 
dious. Second, when we develop reusable classes (such as Die and Account) for 
other programmers, we often want to include a simple example on how to use the 
classes. Instead of providing a separate sample main class, it is more convenient to 
add the main method to these classes. 

We illustrate the procedure, using the Bicycle class from Section 4.1. Suppose 
we want to show a sample use of this class. Instead of creating a separate sample main 
class, we can define the main method to the Bicycle class. Here’s the Bicycle class that 
is also amain class: 


class 

Bi eye 

1 e 

{ 



II 

Dat a 

Me 

mb e r 



P r 

i vat e 

St 

ring 

o wn 

e r N 

II 

Ret ur 

ns 

t h e 

na me 

of 

pu 

bl i c 

St r 

i ng 

get 0 

wn e 


return o wn e r Na me; 

} 


a me; 

this bicycle's owner 

r N a me ( ) { 


//Assigns the name of this bicycle's owner 

public void s e t Own e r Na me ( S t r i n g name) { 

ownerName = name; 

} 


//The main method that shows a sample 
II use of the Bicycle class 

public static void main(String[] args) { 

Bicycle my Bike; 

my Bike = new Bicyclef ); 
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} 


myBi ke. set Owner Na me (" J on java"); 

System, out, pri ntl n ( my B i ke, get Owner Na me ( ) + 

11 owns a bicycle"); 


Remember that the new Bicycle class having the main method does not pro¬ 
hibit us from defining a separate main class. All Java requires us to do is to include 
the main method to the classes we designate as the main class of the program. So it 
is possible (although not likely) that every class in the program has the main 
method, and we can select one of them to be the main class when we execute the 
program. We will use this technique whenever appropriate in the textbook, begin¬ 
ning with this chapter’s sample development section. 


agings to Remember 

Any class can include the main method. For a program to be executable, the desig¬ 
nated main class must include the main method. Other classes in the program may 
or may not include the main method. It is irrelevant to the execution of the program. 



4.11 Sample Development 


Loan Calculator 

In Chapter 3, we wrote a loan calculator program that computes the monthly and total 
payments for a given loan amount, loan period, and interest rate. We wrote the program 
using the simplified program structure in which we had one main class with one method 
(main). We will implement the program again, but this time we use classes called Loan 
and LoanCalculator. 

Problem Statement 

The problem statement is the same as that in Chapter 3. We repeat the statement to 
refresh your memory: 

Write a loan calculator program that computes both monthly and total pay¬ 
ments for a given loan amount, annual interest rate, and loan period. 

Overall Plan 

The tasks we identified in Chapter 3 for the program are still the same: 

1 . Get three input values: loanAmount, interestRate, and loanPeriod. 

2. Compute the monthly and total payments. 

3. Output the results. 
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The main difference in this implementation lies in the use of additional classes. In¬ 
stead of building the program by using only the main class and performing all the tasks 
in one big main method, we will define two classes Loan and LoanCalculator. An 
instance of the LoanCalculator class acts as a top-level agent that manages all other 
objects in the program, such as Loan and Scanner. The Loan class captures the logic of 
loan calculation. A single instance of the Loan class represents a loan, so if the program 
deals with five loans, for example, then five Loan objects will be created in the program. 
We will make the LoanCalculator class the main class of the program by adding the main 
method to it. Figure 4.8 shows the program diagram. 

Notice that the roles that LoanCalculator and Loan play in the program are quite 
different. The Loan class is a generic class that provides a service (e.g., loan computa¬ 
tion and currency conversion) and is intended to be reused by different programs.The 
LoanCalculator class, on the other hand, is a class designed specifically for this pro¬ 
gram, so the class is not intended for reuse by other programs. It is important to recog¬ 
nize this distinction because the way we design reusable and nonreusable classes is 
service quite different. We call the class that provides some type of service a service provider 

provider anc | the class that manages other classes and objects in a program a controller. In gen¬ 

eral, a service provider is designed as a reusable class, while a controller is desiqned as 
controller ... 

a nonreusable class. 

What would be the development steps for this program? If we have multiple 
classes to implement, we can develop the program in either a top-down or a bottom- 
top-down up manner. With the top-down development, we develop in a kind of outside-in 

develop- fashion. We develop the top-level controller class first. But to test its functionalities 

fully, we need the service objects it uses. In a top-down development, we use tempo¬ 
rary dummy service objects that return a fake value from their methods. After we 
verify that the controller class is working correctly, we then complete the service class 
with the real methods. The top-down development for this program will implement 
the LoanCalculator class first with the dummy Loan class and then the real Loan 
class. 


LoanCalculator 


-^7 


Loan 




Scanner 


Figure 4.8 The program diagram for the LoanCalculator program. 
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4.11 Sample Development— continued 


bottom-up 

develop¬ 

ment 


develop¬ 
ment steps 


With the bottom-up development, we develop in the reverse inside-out fashion; 
that is, we develop the service classes first. To test the service classes, we write a tempo¬ 
rary dummy main class. After the service classes are done, we complete the top-level class 
that uses these service classes. The bottom-up development for this program imple¬ 
ments the Loan class first fully and then the LoanCalculator class. For both approaches, 
the classes are developed incrementally as usual. 

For this sample development, we will adopt the top-down development. We will 
leave the bottom-up development for this program as an exercise. For some sample ap¬ 
plications in the later chapters, we will adopt the bottom-up development. We implement 
this program in five steps: 

1 . Start a skeleton of the LoanCalculator class. The skeleton LoanCalculator class 
will include only an object/variable declaration and a constructor to create 
objects. Define a temporary placeholder Loan class. 

2. Implement the input routine to accept three input values. 

3. Implement the output routine to display the results. 

4. Implement the computation routine to compute the monthly and total payments. 

5. Finalize the program, implementing any remaining temporary methods and 
adding necessary methods as appropriate. 


Step 1 Development: Program Skeleton 

step 1 Since the LoanCalculator object is the top-level agent of the program that manages 

design other objects, we need a method to create these objects. We do this in the constructor.We 

define separate methods for input, computation, and output to organize the class more 
logically. Designing a set of single-task methods is more manageable and easier to un¬ 
derstand than having one method that performs all three tasks of input, computation, 
and output. We will call the methods getlnput, computePayment, and displayOutput. 
We will also include one method called describeProgram that describes the purpose of 
the program to the user. 

Since an instance of the class is the top-level agent, much as a general contractor, 
we will provide one method the programmer can call to control the whole operation. We 
will name the method start and define it as follows: 

public void start! ) { 

descri beProgram(); 
get I nput ( ); 
computerPayment (); 
displayOutput!); 

} 
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stub 


With this method, we can then call the main method as follows: 

public static void main(String[] a r g s ) { 

LoanCaIcuI ator calculator = new LoanCaI cuI ator (); 
c a I c ul a t or . s t a r t () ; 


} 

it is possible to define the main method to make it call the four operation methods 
(describeProgram, computePayment, getlnput, and displayOutput) directly, elimi¬ 
nating the need to define the start method. However, such organization limits the flexi¬ 
bility and usability of the class. By defining the start method, if other programmers want 
to use the LoanCalculator class in their programs, they need only call the start method. 
Without the start method, they have to call the four methods and remember to call them 
in the correct order. Although the difference is not dramatic in this particular case, it can 
be in the cases when the classes are more complex and the number of classes in a pro¬ 
gram is large. 

Let's summarize the methods we will define for the LoanCalculator class: 


Design Document: The LoanCal cul ator Class 

Method 


Visibility 

Purpose 

start 


public 

Carries out the loan calculation by 
calling the other private methods. 

computePayment 

private 

Given three parameters—loan amount, 


loan period, and interest rate—it com¬ 
putes monthly and total payments. 
The actual computation is done by a 
Loan object. 


des c 

r i b e P r o g r a m 

pr i 

v a t e 

Displays a short description of the 
program. 

d i s p 

1 ayOut put 

pr i 

v a t e 

Displays the result—monthly and total 
payments. 

get 1 

nput 

pr i 

vat e 

Uses Scanner to get three input 


values—loan amount, loan period, and 
interest rate. 


Notice that only the start method is public. We declare all other methods as private 
because we do not want any client programmers to use them directly; we want the client 
programmers to be able to call only the start method. 

In this step, we define the four private methods with only a temporary output 
statement inside the method body to verify that the methods are called correctly. A 
method that has no "real" statements inside the method body is called a stub. The four 
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4.11 Sample Development— continued 


methods are defined as follows: 

private void descri beProgramf) { 

System, out. pri ntl n("i nsi de descri beProgram"); //TEMP 

} 

private void g e 11 n p u t ( ) { 

System, out. pri ntl n("i nsi de get Input 1 '); II TEMP 

} 

private void comput ePayment () { 

System, out. pri ntl n("i nsi de computePayment"); //TEMP 

} 

private void display Output!) { 

System, out. pri ntl n("i nsi de display Output' 1 ); //TEMP 

} 

Notice the comment marker //TEMP after the output statements. It is our convention to 
attach this comment marker so we can easily and quickly locate temporary statements. 
We use System.out for temporary output. 

The purpose of the skeleton LoanCalculator class is to declare and create all the 
necessary data members. At this step, we know of only one object that will be used by 
LoanCalculator, namely, a Loan object. The declaration part of the LoanCalculator class 
will be as follows: 

class LoanCalculator { 
private Loan loan; 


} 

At this point, the constructor for the LoanCalculator class is very simple.The only 
data member is a Loan object, so we will create it in the constructor as follows: 

public LoanCalculator! ) { 
loan = new Loan! ); 

} 

For this constructor to work properly, we need the definition for the Loan class. We begin 
with the minimalist skeleton code for the Loan class: 

class Loan { 

public Loan! ) { 

} 

} 
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step 1 code 


Let's put our design in an actual code.The skeleton LoanCalculator class is defined 
as follows. 



Chapter 4 Sample Develop me nt: Loan Calculation (Step 1) 


File: Stepl/LoanCalcul ator.j ava 

*1 

class LoanCalculator { 

II Data me mb e r s 

private Loan loan; 

/ / Mai n met hod 

public static void mai n(Stri ng[] arg) { 

LoanCalculator calculator = new LoanCalculator)); 
cal cul a t o r. start)); 

} 

//Constructor 

public LoanCalculator)) { 

loan = new Loan)); 

} 


II Top-level method that calls other private methods 

public void start)) { 

descri beProgram)); //tell what the program does 
getlnput)); //get three input values 

computePayment)); //compute the monthly payment and total 
di s pi ayOut put () ; //display the results 


II Computes the monthly and total loan payments 

private void computePayment)) { 

System, out. println)" inside computePayment"); //TEMP 

} 


II Provides a brief explanation of the programto the user 

private void descri beProgram)) { 

System, out. println) "inside descri beProgram"); //TEMP 

} 


II Displays the input values and monthly and total payments 

private void display Output)) { 

System, out. println) "Inside di spl ayOutput"); //TEMP 

} 
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4.11 Sample Development—cont/nued 


II Gets three input val ues-l oan amount, interest rate, and 
II loan period-using an InputBox object 

private void get I nput ( ) { 

System, out. p r i n 11 n (" inside get I nput"); II TEMP 

} 

} 


And finally the skeleton Loan class is defined as follows. 



Chapter 4 Sample Develop me nt: Loan Calculation (Step 1) 
File: Stepl/Loan.j ava 

*1 

class Loan { 

public L o a n ( ) { 

} 


We run the step 1 program and verify that the following text appears in the standard out¬ 
put window: 


i ns i 

de 

descri beProgram 

i ns i 

de 

get 1 nput 

i ns i 

de 

computePayment 

i ns i 

de 

di spl ayOut put 


After the step 1 program is compiled and executed correctly, we move on to 
step 2. 


Step 2 Development: Accept Input Values 

step2 In the second step of coding, we implement the getlnput method. We will reuse the 

design input routine we derived in Chapter 3. When we receive three input values, we must pass 

these values to the Loan object loan. We will add three data members to keep track of 
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the three input values and one constant to aid the conversion: 


s Loan { 



private 

static 

final i nt MONTHSJ N_YEAR 

private 

double 

1 o a n A mo u n t; 

private 

double 

monthl yl nterest Rate; 

private 

i nt 

n u mbe r Of P a y me nt s; 


} 

Notice that the annual interest rate and loan period expressed in the number of years are 
the input, but we are keeping monthly interest rate and the number of monthly payments 
for the loan period to make them more compatible to the loan calculation formula we are 
using. We need to define three set methods (mutators) for interest rate, loan period, and 
loan amount. A set method for the number of payments, for example, can be defined as 
follows: 

public void setPeriod(int peri odl nYear) { 

number Of Payments = peri odl nYear * MO NTHS_I N_YEAR; 

} 

We define a complementary set of accessor methods. The getPeriod method, for 
example, is defined as 

public i nt get Peri od( ) { 

return ( number Of Payments / MONTHS IN YEAR); 

} 

Notice that the value returned by an accessor may or may not be the data member. It is 
possible that the value returned is derived from the data member, as was the case with 

the getLoanPeriod method. 

We mentioned in Section 4.4 the importance of a constructor initializing an object 
properly. Now that we have associated data members to the Loan class, let's define a con¬ 
structor that accepts arguments: 

public Loan(double amount, double rate, int period) { 
setAmount( amount ); 
setRate (rate ); 
set Peri od ( peri od); 

} 

Having this updated Loan class, we are now ready to tackle the getlnput method 
of the LoanCalculator class. We perform the input routine as we did in the sample pro¬ 
gram from Chapter 3: 

Scanner scanner = new Scanner! System, i n) ; 

System, out. print! “Loan Amount (Dollars+Cents): "); 
loanAmount = scanner.nextDoubl e(); 
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4.11 Sample Development— continued 


System, out. print! “Annual Interest Rate (e.g., 9,5): "); 
annua I I nterestRate = scanner. next DoubI e () ; 

System, out. print! "Loan Period - # of years: "); 

I oanPeri od = scanner, ne x tI n t ( ); 

After getting three input values, we create a new Loan object as 

loan = new Loan(l oanAmount, 

annual Interest Rate, 

IoanPeri od); 

Finally, we include test output statements to verify that the values are read in and 
assigned to loan correctly: 

System, out. println!" Loan A mount: $" 

+ loan.getAmount!)); 

System, out. println! “Annual Interest Rate:" 

+ I o a n. g e t R a t e ( ) + " %" ) ; 

System, out. println! "Loan Period (years):" 

+ I oan. getPeri od()); 

From this point on, to maintain a focus on the changes we are making, we show 
only the portion where we made modifications or additions. Unchanged portions are 
represented by three dots (...). Please refer to the actual source file for the viewing of 
complete source code. Here's the step 2 LoanCalculator class: 


Chapter 4 Sample Develop me nt: Loan Calculation (Step 2) 
File: Step2/LoanCal cul ator.j ava 

*/ 

import java.util.*; 
class LoanCalculator { 

public LoanCalculator!) { 

} 


private void get I nput ( ) { 

double I oanAmount, annual I nterestRate; 
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int I oanPeri od; 

Scanner scanner = new Scanner(System. in); 

System, out. print! “Loan Amount ( Do I I a r s+Ce nt s) : " ); 
loanAmount = scanner, next Double!); 

System, out. print! "Annual Interest Rate (e. g. , 9.5):"); 
a n nua I I nt er es t Ra t e = s c a n ne r. next Do ub I e () ; 

System, out. print!“ Loan Period - # of years:"); 

I oanPeriod = scanner, ne xtI n t( ); 

II create a new loan with the input values 

loan = new Loan(l oanAmount, annual I nterestRate,I oanPeri od); 

II TEMP 

System, out. pri ntl n("Loan Amount: $" + I oan, get Amount ()) ; 

System, out. println! " Annual Interest Rate:" 

+ I o a n. g e t R a t e () + " %" ) ; 

System, out, println! 11 Loan Period (years):" + I oan. getPeri od()); 

//TEMP 

} 


The step 2 Loan class is as follows: 



/* 


Chapter 4 Sample Development 
File: Step2/Loan.j ava 


Loan Calculation (Step 2) 


*1 


class Loan { 

private final i nt 
private double 
private double 
private int 


MONTHS J N _ Y E A R = 12; 
I oanAmount; 
monthl yl nterestRate; 
n u mb e r Of Pa y me nt s; 
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4.11 Sample Development— continued 


//Constructor 

public Loan( double amount, double rate, int period) { 
setAmount (amount) ; 
s e t R a t e (rate ) ; 
set Peri od( peri od) ; 

} 

//Returns the loan a mount 

public double g e t A mount! ) { 
return loanAmount; 

} 

//Returns the loan period in number of years 

public int getPeri od( ) { 

return number Of Payment s / MO N T H S _ I N _ Y E A R; 

} 

//Returns the loan's annual interest rate 

public double get Rat e( ) { 

return monthI yI nterestRate * 100.0 * MONTHS_I N_YEAR; 

} 

II Sets the loan amount 

public void setAmount(double a mount) { 
loanAmount = a mount; 

} 

II Sets the annual interest rate 

public void setRate ( double annual Rate) { 

mont hi y I nt er es t Ra t e = annual Rate / 100.0 / MONT HS_I N_YEAR; 

} 

II Sets the loan period 

public void setPeri od ( i nt periodl nYears) { 

number Of Payments = peri odlnYears * MO NTHS_I N_YEAR; 

} 


step 2 test 


As before, to verify the input routine is working correctly, we run the program multiple 
times. For each run, we enter a different set of data to verify that the values entered are 
displayed correctly. 
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step 3 
design 


Step 3 Development: Output Values 

In the third step of development, we implement the displayOutput method. We will 
reuse the design of output layout from Chapter 3. The actual task of computing the 
monthly and total payments is now delegated to the Loan class, so we will add two 
methods— getMonthlyPayment and getTotalPayment —to the Loan class. The focus 
in step 3 is the layout for output, so we will define a temporary dummy code for these two 
methods in the following manner: 

public double getMonthlyPayment) ) { 
return 132.15; //TEMP 

} 

public double getTotalPayment) ) { 
r et ur n 1 5 8 5 8.1 0; //TEMP 

} 

To display the monthly and total payments, we add the following code in the 

displayOutput method: 


private void di s pi ayOut put ( ) { 


} 


//echo print the Input values here 

System, out. println)" Monthly payment is $ " + 

I oan. getMonthl yPayment) ) ); 
System, out, println)" TOTAL payment Is $ " + 

I oan. getTotal Payment)) ); 


Notice that by defining the getMonthlyPayment and getTotalPayment methods in the 
Loan class, the computePayment method of LoanCalculator becomes redundant and 
no longer needed. So we will remove it in this step, 
step 3 code Here are the modified LoanCalculator and Loan classes: 


Chapter 4 Sample Development: Loan Calculation (Step 3) 
File: Step3/LoanCal cul ator.j ava 

*/ 

import java,util.*; 
class LoanCalculator { 

II computePayment method is re moved from the source file 

private void displayOutput)) { 

System, out. pri ntl n("Loan Amount: $" + I oan. get Amount ()) ; 
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4.11 Sample Development— continued 


System, out, p r i n 11 n ( " Annual Interest Rate:" 

+ I o a n. g e t R a t e ( ) + " %" ) ; 

System, out, pri ntl n("Loan Period (years): " + loan.getPeriod(l); 

System, out, p r i n 11 n ( " Monthly payment is $ " + 

I oan. getMonthl yPayment()); 
System, out. pri ntl n( " TOTAL payment is $ " + 

I oan, getTotal Payment()); 


private void getlnputf) { 

II same code but the temporary echo print statements 
II are r e mo v e d 

} 

} 


Chapter 4 Sample Development: Loan Calculation (Step 3) 
File: Step3/Loan.j ava 


class Loan { 


public double getMonthl yPayment( ) { 
return 132.15; //TEMP 

} 

public double getTotal Pay me nt( ) { 
return 1 5 8 5 8, 1 0; II TEMP 

} 


} 


To verify the output routine is working correctly, we run the program multiple times and 
verify that the layout looks okay for different values. It is common for a programmer to run 
the program several times before the layout looks clean on the screen. 
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Step 4 Development: Compute Loan Amount 

In the fourth step of development, we replace the temporary getMonthlyPayment and 
step 4 getTotalPayment methods with the final version. The changes are made only to the 

design Loan class.The other two classes remain the same. 

Here's one possible way to define the two methods: 

private double monthl yPayment; 

public double getMonthlyPayment) ) { 
monthlyPayment = 
return monthlyPayment; 

} 

public double getTotalPayment) ) { 

return monthlyPayment * n u mbe r Of P a y me nt s; 

} 

The idea is to use the value of the data member monthlyPayment set by the 
getMonthlyPayment method in computing the total payment. This setup is problematic 
because the getTotalPayment method will not work correctly unless getMonthly¬ 
Payment is called first. It is considered a very poor design, and generally unacceptable, 
to require the client programmer to call a collection of methods in a certain order. 
We must define the two methods so they can be called in any order, not necessarily in the 
order of getMonthlyPayment and getTotalPayment. The correct way here is to call 
getMonthlyPayment from the getTotalPayment method: 

private double getTotalPayment) ) { 
double total Pay ment; 

total Payment = getMonthlyPayment)) * number Of Payments; 
return total Pay ment; 

} 

ste 4 code With this approach the data member monthlyPayment is not necessary. 

Here's the updated Loan class: 



Chapter 4 Sample Develop me nt: Loan Calculation (Step 4) 


File: Step4/Loan.j ava 

*/ 

class Loan { 


public double getMonthlyPayment) ) { 
double monthlyPayment; 
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4.11 Sample Development— continued 


monthl yPayment = (loa 
/ 

(1 - 



r 

et 

ur n 

mo nt h 

1 yP 

ay 

me nt 

} 








pul 

)l i 

c 

do u 

bl e ge 

t To 

t a 

1 Pay 


d 

ou 

bl e 

total 

Pay 

me 

nt; 


t 

ot 

al P 

a y me n t 

= 

ge 

t Mo n 


r 

et 

ur n 

total 

Pay 

me 

nt; 


} 


nAmount * monthl yl nterestRate) 

Mat h. p o w( 1/ ( 1 + monthl yl nterestRate) 
number Of Payment s ) ) ; 

me n t ( ) { 

t hi y Payment! ) * number Of Payments; 


} 


After the method is added to the class, we need to run the program through a 
number of test data. As in Chapter 3, we made the assumption that the input values must 
be valid, so we will only test the program for valid input values. For sample test data, we 
repeat the table from Chapter 3. The right two columns show the correct results. Remem¬ 
ber that these input values are only suggestions, not a complete list of test data. You must 
try other input values as well. 


Input 

Output 

(shown up to three decimal 
places only) 

Annual Loan 

Loan Interest Period 

Amount Rate (in Years) 

Monthly Total 

Payment Payment 

10000 10 10 

15000 7 15 

10000 12 10 

0 10 5 

30 8.5 50 

132.151 15858.088 

134.824 24268.363 

143.471 17216.514 

0.000 0.000 

0.216 129.373 


step 5 Step 5 Development: Finalize 

design Now in the last step of development, we finalize the class declaration by completing the 

describeProgram method, the only method still undefined. We may give a very long 
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step 5 code 


description or a very terse one. An ideal program will let the user decide. We do not know 
how to write such code yet, so we will display a short description of the program using 

System.out. 

Another improvement is the display of monetary values in two decimal places. 
We can format the display to two decimal places by using the DecimalFormat class as 
explained in Chapter 3. 

Here's the describeProgram method; 


at e 

voi 

d descri beProgr; 

a m() { 




Syst 

e m. 

out. pri ntl n 






( 

“This program c( 

o mp u tes 

the mo n t h 1 y 

and 

t ot 

Syst 

e m. 

out. pri ntl n 






( 

" p a y me n t s for a 

given 1 

o a n a mo u n t, 

a n n 

u a 1 

Syst 

e m. 

o ut. p r i nt 1 n 






( 

"interest rate, 

and 1 o; 

s n period ( # 

of 

year 

Syst 

e m. 

out.pri ntl n("\n' 






} 


You may feel that there's not much testing we can do in this step. After all, we add only a 
single method that carries out a simple output routine. However, many things can go 
wrong between step 4 and step 5. You may have deleted some lines of code inadver¬ 
tently. You may have deleted a necessary file by mistake. Anything could happen. The 
point is to test after every step of development to make sure everything is in order. 


Summary 


Data members of a class refer to the instance and class variables and 
constants of the class. 

An object’s properties are maintained by a set of data members. 

Class methods can access only the class variables and class constants. 
Instance methods can access all types of data members of the class. 

Public methods define the behavior of an object. 

Private methods and data members (except certain class constants) are 
considered internal details of the class. 

Components (data members and methods) of a class with the visibility 
modifier private cannot be accessed by the client programs. 

Components of a class with the visibility modifier public can be accessed by 
the client programs. 

A method may or may not return a value. One that does not return a value is 
called a void method. 
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A constructor is a special method that is executed when a new object is 
created. Its purpose is to initialize the object into a valid state. 

Memory space for local variables and parameters is allocated when a method 
is called and deallocated when the method terminates. 

A public method that changes a property of an object is called a mutator. 

A public method that retrieves a property of an object is called an accessor. 

Dot notation is not used when you call a method from another method of the 
same class. 

Any class can be set as the main class of a program by adding the main 
method to it. In the main method, an instance of this class is created. 


Key Concepts 


programmer-defined classes 

accessibility (visibility) modifiers 

void methods 

value-returning methods 

accessors 

mutators 

constructors 

arguments 


parameters 
client programmers 
information hiding 
encapsulation 
local variables 
service providers 
controllers 
stub 


Review Exercises 


Consider the following class declaration. 

class Questi onOne { 


public final int 

A = 345; 

public int 

b; 

private float 

c ; 

private void metho 

dOne ( int 


b = a; 

} 


public float met h o d T wo ( ) { 
return 23; 

} 
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Identify invalid statements in the following main class. For each invalid 
statement, state why it is invalid. 

class Q1 Ma i n { 

public static void mai n(Stri ng[] args) { 

Ques t i onOne q 1; 

ql = new Question0ne ( ); 

ql.A = 12; 
ql. b = 12; 
ql.c = 12; 

ql. met hodOnel12) ; 
ql.methodOne) ); 

System, out. pri ntl n ( q1. methodTwo( 12) ) ; 
ql.c = ql. met hodTwo) ); 

} 

} 


2. What will be the output from the following code? 
class Q2 Ma i n { 

public static void mai n(Stri ng[] args) { 
Quest i onTwo q2; 
q2 = new Questi onTwo( ); 
q 2. i n i t ( ) ; 

q2.increment(); 

q2.increment(); 

System, out. pri ntl n ( q 2. getCountf) ); 

} 

} 

class Questi onTwo { 

private int count; 

public void init( ) { 
count = 1; 

} 

public void increment) ) { 
count = count +1; 

} 

public int get Count ( ) { 
return count; 

} 
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3. What will be the output from the following code? Q3Main and 
Question Three classes are the slightly modified version of Q2Main and 
QuestionTwo. 

class Q3Mai n { 

public static void mai n(Stri ng[] args) { 

QuestionThr ee q3; 

q3 = new Questi onThree( ); 

q 3. i n i t () ; 

q 3. count = q3.increment() + q3.increment(); 

System, out. p r i n 11 n ( q 3. i n c r e me n t ( ) ) ; 

} 

} 

class Questi onThr ee { 
public int count; 

public void i ni t ( ) { 

count = 1; 

} 

public int increment) ) { 
count = count + 1; 
return count; 

} 

} 

4. Is there any problem with the following class? Is the passing of an argument 
to the private methods appropriate? Are the data members appropriate? 
Explain. 


Problem Questi on4 

*/ 

class MyText { 

private String word; 
private String temp; 

private int i dx; 

public String firstLetter) ) { 
i d x = 0; 

return getLetter(word); 

} 

public String I a s t L e11 e r ( ) { 
idx = word, length!) - 1; 
return getLetter(word); 

} 


www.it-ebooks.info 



Exercises 217 


private String get Letter ( Stri ng str) { 
temp = str.substri ng(i dx, idx+1); 
return t emp; 

} 

} 



Level 1 Programming Exercises ★ 

5. In the RollDice program, we created three Die objects and rolled them once. 
Rewrite the program so you will create only one Die object and roll it three 
times. 

6. Write a program that computes the total ticket sales of a concert. There are 
three types of seatings: A, B, and C. The program accepts the number of 
tickets sold and the price of a ticket for each of the three types of seats. The 
total sales are computed as follows: 

total Sal es = numberOfA_Seats * pri cePerA_Seat + 

number OfB _ S e a ts * pri cePerB_Seat + 
number OfC _ S e a ts * pri cePerC_Seat; 

Write this program, using only one class, the main class of the program. 

7. Define a new class named Temperature. The class has two accessors—to- 
Fahrenheit and toCelsius —that return the temperature in the specified unit 
and two mutators— setFahrenheit and setCelsius —that assign the temperature 
in the specified unit. Maintain the temperature internally in degrees Fahrenheit. 
Using this class, write a program that inputs temperature in degrees 
Fahrenheit and outputs the temperature in equivalent degrees Celsius. 

8. Using the Temperature class from Exercise 7, write a program that inputs 
temperature in degrees Celsius and outputs the temperature in equivalent 
degrees Fahrenheit. 

9. Write a program that computes the area of a circular region (the shaded area 
in the diagram), given the radii of the inner and the outer circles, q and r 0> 
respectively. 
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We compute the area of the circular region by subtracting the area of the 
inner circle from the area of the outer circle. Define a Circle class that has 
methods to compute the area and circumference. You set the circle’s radius 
with the setRadius method or via a constructor. 

10. Modify the Bicycle class so instead of assigning the name of an owner 
(Student), you can assign the owner object itself. Model this new Bicycle 
class after the LibraryCard class. 


Level 2 Programming Exercises ★★ 

11. Extend the LibraryCard class by adding the expiration date as a new property 
of a library card. Define the following four methods: 


II set 

s 

t h e 

expi rati on 

dat 

publ i 

c 

void 

set ExpDat 

e( Gr 

II ret 

ur 

ns t 

he expi r at 

i o n 

publ i 

c 

i nt 

get ExpYear 

( ) 

II ret 

ur 

ns t 

he expi r at 

i o n 

p u b 1 i 

c 

i nt 

get ExpMont 

h ( ) 

II ret 

ur 

ns t 

he expi r at 

i o n 

publ i 

c 

i nt 

get ExpDayl 

) { 


e 

egorianCal endar date) {...} 

year 

{ ... } 

mo nt h 

{ ... } 

day 

... } 


12. Write a program that displays the recommended weight (kg), given the 
user’s age and height (cm). The formula for calculating the recommended 
weight is 

r e c o mme ndedWeight = (height - 100 + age / 10) * 0.90 

Define a service class named Height and include an appropriate method for 
getting a recommended weight of a designated height. 

13. Redo Exercise 9 by using a Seat class. An instance of the Seat class keeps 
track of the ticket price for a given type of seat (A, B, or C). 

14. Write a WeightConverter class. An instance of this class is created by 
passing the gravity of an object relative to the Earth’s gravity (see 
Exercise 16 on page 144). For example, the Moon’s gravity is 
approximately 0.167 of the Earth’s gravity, so we create a 
WeightConverter instance for the Moon as 

WeightConverter mo o n We i g h t; 

moonWei ght = new WeightConverter) 0.167 ); 

To compute how much you weigh on the Moon, you pass your weight on 
Earth to the convert method as 

your Mo on Weight = mo on Weight. convert! 160 ); 

Use this class and redo Exercise 16 on page 144. 
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Development Exercises 

For the following exercises, use the incremental development methodology to 
implement the program. For each exercise, identify the program tasks, create a 
design document with class descriptions, and draw the program diagram. Map out 
the development steps at the start. Present any design alternatives and justify your 
selection. Be sure to perform adequate testing at the end of each development step. 

15. Redo Exercise 30 on page 149, but this time define and use programmer- 
defined classes. 

16. Write a program that accepts the unit weight of a bag of coffee in pounds 
and the number of bags sold and displays the total price of the sale, 
computed as follows: 

totalPrice = bag Weight * number Of Bags * pricePerLb; 
total Pri ceWi thTax = totalPrice + totalPrice * taxrate; 

Display the result in the following manner: 


Number of bags sold 
Weight per bag 
Price per pound 
Sales tax 


32 

5 I b 
$5. 99 
7. 2 5% 


Total price: $ 1027.88 


[ Format to two 
I decimal places. 


Define and use a programmer-defined CoffeeBag class. Include class 
constants for the price per pound and tax rate with the values $5.99 per 
pound and 7.25 percent, respectively. 

17. In the Turtle exercises from the earlier chapters, we dealt with only one 
Turtle (e.g., see Exercise 32 on page 150). It is possible, however, to let 
multiple turtles draw on a single drawing window. To associate multiple 
turtles to a single drawing, we create an instance of TurtleDrawingWindow 
and add turtles to it as follows: 
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Ordinarily, when you start sending messages such as turn and move to a 
Turtle, it will begin moving immediately. When you have only one Turtle, this 
is fine. However, if you have multiple turtles and want them to start moving 
at the same time, you have to first pause them, then give instructions, and 
finally command them to start moving. Here’s the basic idea: 

wi nky. pause( ); 
pi nky. pause! ): 
ti nky. pause! ): 

II give instructions to turtles here, 

//e.g,, pi nky. move! 50): etc. 

//now let the turtles start moving 
wi n ky. s t a r t ( ); 
pi nky.st art ( ); 
ti nky. start! ); 

Using these Turtle objects, draw the following three triangles: 



Use a different pen color for each triangle. Run the same program without 
pausing and describe what happens. 
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Selection Statements 


Objectives 


After you have read and studied this chapter,you 
should be able to 

• Implement selection control in a program 
using if statements. 

• Implement selection control in a program 
using switch statements. 

• Write boolean expressions using relational and 
boolean operators. 

• Evaluate given boolean expressions correctly. 

• Nest an if statement inside another if 
statement's then or else part correctly. 

• Describe how objects are compared. 

• Choose the appropriate selection control 
statement for a given task. 

• Define and use enumerated constants. 

• Draw geometric shapes on a window. 
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Introduction 



sequential 

execution 


control 

statement 


D , decisions, decisions. From the moment we are awake until the time 

we go to sleep, we are making decisions. Should I eat cereal or toast? What 
should I wear to school today? Should I eat at the cafeteria today? And so 
forth. We make many of these decisions by evaluating some criteria. If the 
number of students in line for registration seems long, then come back tomorrow 
for another try. If today is Monday, Wednesday, or Friday, then eat lunch at the 
cafeteria. 

Computer programs are no different. Any practical computer program con¬ 
tains many statements that make decisions. Often a course of action is determined 
by evaluating some kind of a test (e.g., Is the remaining balance of a meal card 
below the minimum?). Statements in programs are executed in sequence, which is 
called sequential execution or sequential control flow. However, we can add 
decision-making statements to a program to alter this control flow. For example, 
we can add a statement that causes a portion of a program to be skipped if 
an input value is greater than 100. Or we can add a statement to disallow the pur¬ 
chase of food items if the balance of a meal card goes below a certain minimum. 
The statement that alters the control flow is called a control statement. In this 
chapter we describe some important control statements, called selection state¬ 
ments. In Chapter 6 we will describe other control statements, called repetition 
statements. 


if statement 


5.1 


The if Statement 


There are two versions of the if statement, called if-then-else and if-then. We begin 
with the first version. Suppose we wish to enter a student’s test score and print out 
the message You did not pass if the score is less than 70 and You did pass if the score 
is 70 or higher. Here’s how we express this logic in Java: 


This statement is 
executed if testScore 
is less than 70. 

This statement is 
executed if testScore 
is 70 or higher. 


Scanner scanner = new Scanner ( System, in); 
System, out. print) "Enter test score: "); 
i nt testScore = scanner. nex11 nt () ; 
if (testScore < 70) 

System, out. pri ntl n("You did not pass") 

else 

System, out. pri ntl n("You did pass"); 


We use an if statement to specify which block of code to execute. A block of code 
may contain zero or more statements. Which block is executed depends on the 
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Boolean Expression 


if ( ! testScore < 70 j ) 


The then Block \ 


System.out ,println( "You did not pass”); 


el se 


The else Block -! System, out. println( "You did pass"); 


Figure 5.1 Mapping of the sample if-then-else statement to the general format. 


boolean 

expression 


if-then-else 

syntax 


relational 

operators 


result of evaluating a test condition, called a oolean expression. The if-then-else 
statement follows this general format: 

if ( <b o o I e a n expression ) 

<t h e n b I o c k > 

else 

<el se bI oc k> 

Figure 5.1 illustrates the correspondence between the if-then-else statement we 
wrote and the general format. 

The <boolean expression> is a conditional expression that is evaluated 
to either true or false. For example, the following three expressions are all 
conditional: 

testScore < 80 
testScore * 2 > 350 
30 < w / ( h * h) 

The six relational operators we can use in conditional expressions are: 


< 

n 

less than 

<= 

n 

less than or 

== 

n 

equal to 

! = 

n 

not equal to 

> 

n 

greater than 

>= 

n 

greater than 


Flere are some more examples: 


a * a <= c 

//true 

1 f 

a * a is less than or equal to c 

x + y ! = z 

//true 

1 f 

x +y is not equal to z 

a == b 

II true 

1 f 

a is equal to b 
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Hints, 
Pitfalls 



One very common error in writing programs is to mix up the assignment and 
equality operators. We frequently make the mistake of writing 

if (x = 5) ... 

when we actually wanted to say 

if (x == 5) ... 


If the boolean expression evaluates to true, then the statements in the cthen 
block> are executed. Otherwise, the statements in the <else block> are executed. 
We will cover more complex boolean expressions in Section 5.2. Notice that we can 
reverse the relational operator and switch the then and else blocks to derive the 
equivalent code, for example, 

if (testScore >= 70) 

System, out. pri ntl n("You did pass 1 '); 

else 

System, out. pri ntl n("You did not pass"); 

Notice that the reverse of < is >=, not >. 

selection The if statement is called a selection or >ranching statement because it selects 

statement (or branches to) one of the alternative blocks for execution. In our example, either 

System, out. printl n("You did not pass"); 
or 

System, out. pri ntl n("You did pass"); 

is executed depending on the value of the boolean expression. We can illustrate a 
branching path of execution with the diagram shown in Figure 5.2. 



Figure 5.2 The diagram showing the control flow of the sample if-then-else statement. 
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In the preceding if statement, both blocks contain only one statement. The 
then or else block can contain more than one statement. The general format for both 
the <then block> and the <else block> is either a 

<s i n g I e state me n t > 


or a 


<compound state me n t > 

where <single statement is a Java statement and <compound statement is a 
sequence of Java statements surrounded by braces, as shown below with n > 0 
statements: 

{ 

<st at ement 1 > 

<st at ement 2> 

<st at ement n> 

} 

If multiple statements are needed in the <then block> or the <else block>, they must 
be surrounded by braces { and }. For example, suppose we want to print out addi¬ 
tional messages for each case. Let’s say we also want to print Keep up the good 
work when the student passes and print Try harder next time when the student does 
not pass. Here’s how: 


if (testScore < 70) 


{ 



System, out. printl n("You did not pass"); 
System, out. p r i n 11 n ( " Try harder next time"); 


else 


\ { 

System, out. pri ntl n("You did pass"); 

System, out. print Inf" Keep up the good work"); 


} 


The braces are necessary to delineate the statements inside the block. Without 
the braces, the compiler will not be able to tell whether a statement is part of the 
block or part of the statement that follows the if statement. 

Notice the absence of semicolons after the right braces. A semicolon is never 
necessary immediately after a right brace. A compound statement may contain zero 
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or more statements, so it is perfectly valid for a compound statement to include only 
one statement. Indeed, we can write the sample if statement as 

if (testScore < 70) 

{ 

System, out. printlnf" You did not pass' 1 ); 

} 

else 

{ 

System, out. printlnf "You did pass"); 

} 

Although it is not required, many programmers prefer to use the syntax for the com¬ 
pound statement even if the then or else block includes only one statement. In this 
textbook, we use the syntax for the compound statement regardless of the number 
of statements inside the then and else blocks. Following this policy is beneficial for 
a number of reasons. One is the ease of adding temporary output statements inside 
the blocks. Frequently, we want to include a temporary output statement to verify 
that the boolean expression is written correctly. Suppose we add output statements 
such as these: 


i f 
/ 

( t es 

t Sco 

r e 

< 

70) 





\ 

Syst 

e m. o 

ut. 

pr 

i nt 1 

n ( 

" i n s i 

de t 

hen: " + t e s t S c o r e ); 

i 

Syst 

e m. o 

lit. 

pr 

i nt 1 

n ( 

"You 

di d 

not pass"); 

/ 

el 

se 









{ 











Syst 

e m. o 

ut. 

pr 

i nt 1 

n ( 

" i n s i 

dee 

Ise: " + testScore); 

} 

Syst 

e m. o 

ut. 

pr 

i nt 1 

n ( 

"You 

di d 

pass"); 

If we always use 

the : 

syntax 

for 

the 

compound 

statement, we just add and delete 


the temporary output statements. However, if we use the syntax of the single state¬ 
ment, then we have to remember to add the braces when we want to include a 
temporary output statement. Another reason for using the compound statement 
syntax exclusively is to avoid the dangling else problem. We discuss this problem 
in Section 5.2. 

The placement of left and right braces does not matter to the compiler. The 
compiler will not complain if you write the earlier if statement as 


i f 

(tests 

core 

< 

70) 





{ 

System. 

out. 

pr i 

nt 1 n ( 

“You 

di d 

not 

pass"); 

/ 

System. 

out. 

pr i 

nt 1 n ( 

"Try 

hart 

1 e r 

next t i me" ) ; } else 

\ 

System. 

out. 

pr i 

nt 1 n ( 

"You 

di d 

pas 

s" ) ; 


System. 

out. 

pr i 

nt 1 n ( 

" Kee 

p up 

t he 

good work");} 
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However, to keep your code readable and easy to follow, you should format 
your if statements using one of the two most common styles: 

' style i j if ( <b o o I e a n expression ) { 

} else { 

} 

style 2 1 if ( <b o o I e a n expression ) 

k J { 

} 

else 

{ 

} 

In this book, we will use style 1, mainly because this style adheres to the code con¬ 
ventions for the Java programming language. If you prefer style 2, then go ahead 
and use it. Whichever style you choose, be consistent, because a consistent look and 
feel is very important to make your code readable. 


o 

q ion 

J Might 
Want to 
Know 


The document that provides the details of code conventions for Java can be found at 
http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html 

This document describes the Java language coding standards dictated in the Java 
Language Specification. It is important to follow the code conventions as closely as 
possible to increase the readability of the software. 


There is a second variation of style 1 in which we place the reserved word else 
on a new line as 


Style 3 


) 


if ( <b o o I e a n expression ) { 

} 

else { 

} 


Many programmers prefer this variation of style 1 because the reserved word else 
aligns with the matching if. However, if we nitpick, style 3 goes against the logic 
behind the recommended style 1 format, which is to begin a new statement at one 
position with a reserved word. The reserved word else is a part of the if statement, 
not the beginning of a new statement. Thus style 1 places the reserved word else to 
the right of the matching if. 
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Again, the actual format is not that important. Consistent use of the same for¬ 
mat is. So, whichever style you use, use it consistently. To promote consistency 
among all programmers, we recommend that everybody to adopt the code conven¬ 
tions. Even though the recommended format may look peculiar at first, with some 
repeated use, the format becomes natural in no time. 

Let’s summarize the key points to remember: 


L^jings to Remember 

Rules for writing the then and else blocks: 

1. Left and right braces are necessary to surround the statements if the then or 
else block contains multiple statements. 

2. Braces are not necessary if the then or else block contains only one statement. 

3. A semicolon is not necessary after a right brace. 



if-then syntax 


Now let’s study a second version of the if statement called if-then. Suppose 
we want to print out the message You are an honor student if the test score is 95 or 
above and print out nothing otherwise. For this type of testing, we use the second 
version of the if statement, whose general format is 

if ( <b o o I e a n expression ) 

<t hen bI oc k> 


The second version contains only the <then block>. Using this version and the 
compound statement syntax, we express the selection control as 

if (testScore >= 95) { 

System, out. pri ntl n("You are an honor student"); 

} 

Figure 5.3 shows the diagram that illustrates the control flow for this if-then state¬ 
ment. We will refer collectively to both versions as the if statement. 

Notice that the if-then statement is not necessary, because we can write any 
if-then statement using if-then-else by including no statement in the else block. For 
instance, the sample if-then statement can be written as 

if (testScore >= 95) { 

System, out. pri ntl n("You are an honor student"); 

} el se { } 

In this book, we use if-then statements whenever appropriate. 

Let’s conclude this section with a sample class that models a circle. We 
will name the class Ch5Circle, and its instances are capable of computing the 
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Figure 5.3 The diagram showing the control flow of the second version of the if statement. 


circumference and area. We will include a test in this class so the methods such 
as getArea and getCircumference return the constant INVALID_DIMENSION when 
the dimension of the radius is invalid. Here’s the ChBCircle class (most comments 
are removed for the sake of brevity): 



I * As the number of methods gets larger, 

Chapter 5 The Circle class we will use this markerto quickly locate 

the program components. Shaded icon 


File: C h 5 C i rcl e.j ava is used for a private element. 

*/ 

class Ch5Ci rcle { 

public static final int I NVALI D_ DI MENSI ON = -1; 
private double radius; 


( \ 

Data Members 


public Ch5Ci rcl e( double r) { 
s et Ra di us ( r ) ; 

} 


public double getArea) ) { 

doubl e result = I NVALI D_DI MEN51 ON; 
if ( I s Radi usVali d() ) { 

result = Math.PI * radius * radius; 


getArea 


} 

return result; 
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} 


public double getCi rcumference( ) { 
double result = I NVALI D_DI ME NS I ON; 
if (isRadiusValid(l) { 

result = 2.0 * Math. PI * radius; 

} 

return result; 

} 

public double getDi ameterf ) { 

double diameter = I NVALI D_DI MENSI ON; 
if (i s Ra d i u s Va I i d () ) { 

diameter = 2.0 * radius; 

} 

return di a me ter; 

} 

publ i c double get Radi us ( ) { 
return radius; 

} 

public void set Di ameterfdoubl e d) { 

if (d > 0) { 

set Radi us ( d/2. 0) ; 

} else { 

set Radi us ( I NVALI D DI MENSI ON) ; 

} 

} 

public void set Radi us ( doubl e r) { 

if (r > 0) { 
radius = r; 

} else { 

radius =1 NVALI D DI MENSION; 

} 

} 

private boolean isRadi usVaIi d ( ) { 

return radius ! = I NVALI D DI MENSI ON; 

} 


getCircumference 


getDiameter 


r 


getRadius 


setDiameter 




’ 


setRadius 


3 


( -;-n 

isRadiusValid 
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Notice the if statement in the getArea method is written as 
if (i sRadi usVali d()) { 

} 

The <boolean expression> in the if statement can be any expression that evaluates 
to true or false, including a call to a method whose return type is boolean, 
such as the isRadiusValid method. The use of such a boolean method often 
makes the code easier to read, and easier to modify if the boolean method is called 
from many methods (e.g., there are three methods calling the isRadiusValid 
method). 

Here’s a short main class to test the functionality of the Ch5Circle class: 


/* 

Chapter 5 S a mp I e Program: Computing Circle Dimensions 
File: C h 5 S a mp lei. java 

*/ 


import java,util.*; 
class Ch5Sampl el { 

public static void mai n(Stri ng[] args) { 
double radius, circumference, area; 

C h 5 C i r c I e circle; 

Scanner scanner = new Scanner ( System, in); 

System, out. print! “Enter radius: "); 
radius = scanner.next Double!); 

circle = new Ch5Ci rcl e(radi us); 

circumference = circle, getCi rcumference! ) ; 

area = ci r cI e, getArea!); 

System, out. println!" Input radius: " + radius); 

System, out. println!" Circumference: " + circumference); 

System, out. println! “ Area: " + area); 

} 

} 
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Notice that the program will display -1.0 when the input radius is invalid. We 
can improve the display by adding an if test in the main program as follows: 

System, out. print! “Circumference: " ) ; 
if (circumference == Ch5Ci rcl e. I NVALI D_DI MENSI ON) { 

System, out. printlnf 1 2 * * * * * * * * 11 Cannot compute, Input invalid"); 

} else { 

System, out, pri ntl n(ci rcumference); 

} 

Another possible improvement in the main program is to check the input value first. 
For instance, 

radius = , , . ; 
if (radius > 0) { 

II do the computation as the sample main method 

} else { 

//print out the error message 

} 

Even when a client programmer does not include appropriate tests in his program, 
we must define a reusable class in a robust manner so it will not crash or produce 
erroneous results. For the Ch5Circle class, we add a test so the data member radius 
is set to either a valid datum or a specially designated value (INVALID_DIMENSION) 
for any invalid data. By designing the class in this manner, we protect the class from 
a possible misuse (e.g., attempting to assign a negative radius) and producing mean¬ 
ingless results, such as -5.88. We always strive for a reliable and robust reusable 
class that will withstand the abuse and misuse of client programmers. 


F— 

Quick 

CHECK 

/ 

V 


1. Identify the invalid if statements: 


a. i f ( a < b ) t h e n 

x = y; 
else 

x = z; 

b. i f ( a < b ) 

else x = y; 


c. i f ( a < b ) 

x = y; 
e I s e { 
x = z; 

}; 

d. i f ( a < b ) { 

x = y; } else 

x = z; 


2. Are the following two if statements equivalent? 

/ * A* / if ( x < y ) 

System, out, printlnf “Hello"); 

else 

System, out, printlnf “Bye"); 

/ * B* / if ( x > y ) 

System, out, printlnf "Bye"); 

else 

System, out, printlnf "Hello"); 
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5.2 Nested if Statements 

The then and else blocks of an if statement can contain any statement including 
another if statement. An if statement that contains another if statement in either its 
nested if then or else block is called a nested if statement. Let’s look at an example. In the 

statement earlier example, we printed out the messages You did pass or You did not pass 

depending on the test score. Let’s modify the code to print out three possible mes¬ 
sages. If the test score is lower than 70, then we print You did not pass, as before. If 
the test score is 70 or higher, then we will check the student’s age. If the age is less 
than 10, we will print You did a great job. Otherwise, we will print You did pass, 
as before. Figure 5.4 is a diagram showing the logic of this nested test. The code 
is written as follows: 

if ( t est Sc or e >= 7 0) { 
if (studentAge < 10) { 

System, out. printlnf" You did a great job"): 

} else { 

System, out. pri ntl n("You did pass ");// 1est score >= 70 
} //and age >= 10 

} else { II test score < 70 

System, out. pri ntl n("You did not pass"); 

} 



Figure 5.4 A diagram showing the control flow of the example nested if statement. 
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Since the then block of the outer if contains another if statement, the 
outer if is called a nested if statement. It is possible to write if tests in different 
ways to achieve the same result. For example, the preceding code can also be 
expressed as 

if (testScore >= 70 && st udentAge < 10) { 

System, out. pri ntl n("You did a great job"); 

} else { 

//either testScore < 70 OR st udentAge >= 10 

if (testScore >= 70) { 

System, out. pri ntl n("You did pass"); 

} else { 

System, out. pri ntl n("You did not pass' 1 ); 

} 

} 

Several other variations can also achieve the same result. As a general rule, we 
strive to select the one that is most readable (i.e., most easily understood) and most 
efficient. Often no one variation stands out, and the one you choose depends on your 
preferred style of programming. 

Here’s an example in which one variation is clearly a better choice. Suppose 
we input three integers and determine how many of them are negative. Here’s 
the first variation. To show the structure more clearly, we purposely do not use the 
braces in the then and else blocks. 

if ( n u ml < 0 ) 
if ( n u m2 < 0 ) 
if ( num3 < 0 ) 
negati veCount 

else 

negati veCount 

else 

if ( num3 < 0 ) 
negati veCount 

else 

negativeCount 

else 

if ( num2 < 0 ) 
if ( num3 < 0 ) 
negati veCount 

else 

negati veCount 

else 

if ( num3 < 0 ) 
negativeCount 

else 

negativeCount 


In this and the following 
examples, we purposely 
do not use the braces so 
we can provide a better 
illustration of the topics 
we are presenting. 


= 3; 

II all 

three are negative 

= 2; 

/ / n u ml 

and num2 are 

negati ve 

= 2; 

/ / n u ml 

and num3 are 

negati ve 

= 1; 

/ / n u ml 

is negative 


= 2; 

/ / n u m2 

and num3 are 

negati ve 

= l; 

/ / n u m2 

is negative 


= l; 

/ / n u m3 

is negative 



= 0; II no negative numbers 
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It certainly did the job. But elegantly? Here’s the second variation: 
negati veCount = 0; 


n u ml < 

0) 





negat 

i veCount 

= negati 

veCount 

+ 

1 

n u m2 < 

0) 





negat 

i veCount 

= negati 

veCount 

+ 

1 

n u m3 < 

0) 





negat 

i veCount 

= negati 

veCount 

+ 

1 


Which version should we use? The second variation is the only reasonable 
way to go. The first variation is not a viable option because it is very inefficient and 
very difficult to read. We apply the nested if structure if we have to test conditions 
in some required order. In this example these three tests are independent of one an¬ 
other, so they can be executed in any order. In other words, it doesn’t matter whether 
we test numl first or last. 

The statement 

negati veCount = negati veCount + 1; 

increments the variable by 1. This type of statement that changes the value of a vari¬ 
able by adding a fixed number occurs frequently in programs. Instead of repeating 
the same variable name twice, we can write it succinctly as 

negati veCount ++; 

Similarly, a statement such as 

count = count - 1; 

can be written as 


count--; 


increment and 

decrement 

operators 


The double plus operator (++) is called the incrementoperator, and the double 
minus operator (—) is the decrement operator (which decrements the variable 
by 1). The increment and decrement operators have higher precedence than unary 
operators. See Table 5.3 on page 243. Note: There are prefix and postfix increment/ 
decrement operators in which the operators come before and after the variable (or an 
expression), respectively. We only use the postfix operators in this book, and the 
precedence rules presented in the table apply to the postfix operators only. 

Notice that we indent the then and else blocks to show the nested structure 
clearly. Indentation is used as a visual guide for the readers. It makes no difference to 
a Java compiler. For example, we make our intent clear by writing the statement as 

if ( x < y) 
if ( z ! = w) 
a = b + 1; 

else 

a = c + 1; 

else 

a = b * c; 
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Rule 1: 
Rule 2: 



It takes some practice before you can write well-formed if statements. Here are 
some rules to help you write the if statements. 


Minimize the number of nestings. 

Avoid complex boolean expressions. Make them as simple as possible. 
Don't include many ANDs and ORs. 

Eliminate any unnecessary comparisons. 

Don't be satisfied with the first correct statement. Always look for 
improvement. 

Read your code again. Can you follow the statement easily? If not, try to 
improve it. 


But to the Java compiler, it does not matter if we write the same code as 

if (x < y)if (z != w) a = b + 1; el s e a = c + 1; else a = b * c; 

Although indentation is not required to run the program, using proper inden¬ 
tation is an important aspect of good programming style. Since the goal is to make 
your code readable, not to follow any one style of indentation, you are free to 
choose your own style. We recommend style 1 shown on page 227. 

The next example shows a style of indentation accepted as standard for a 
nested if statement in which nesting occurs only in the else block. Instead of deter¬ 
mining whether a student passes or not, we will now display a letter grade based on 
the following formula: 



The statement can 

if (SCOT 
Syst e 

else 
if ( s 
sy 

else 
i f 


be written 

as 






e >= 90) 







m. o u t . p r 

i nt 1 

nC 

1 Yoi 

jr 

grade 

is A" 

core >= 

80) 






stem, out 

. pr i 

nt! 

n(' 

'Y 

our g r; 

a d e i s 

(score 

>= ■ 

70) 





System. 

out. 

P r i 

nt! 

n 

( "Your 

grade 


B"! 


is C" ); 


www.it-ebooks.info 








5.2 Nested if Statements 237 


dangling else 
problem 


else 

if (score >= 60) 

System, out. pri ntl n("Your grade is D" ); 

else 

System, out. pri ntl n("Your grade is F" ); 


However, the standard way to indent the statement is as follows: 


if (score >= 90) 

System, out. pri ntl n("Your grade is A"); 

else if (score >= 80) 

System, out. pri ntl n("Your grade is B" ) ; 

else if (score >= 70) 

System, out. pri ntl n("Your grade is C" ); 


else if (score >= 60) 

System, out. pri ntl n("Your grade is D" ); 


else 

System, out. pri ntl n("Your grade is F" ); 


We mentioned that indentation is meant for human eyes only. For example, we 
can clearly see the intent of a programmer just by looking at the indentation when 
we read 


if (x < y) 
if ( x < z ) 

System, out. pri ntl n("Hel I o"); 

else 

System, out. pri ntl n ( "Good bye"); 

A Java compiler, however, will interpret the above as 
if (x < y) 

if (X < Z ) 

System, out. pri ntl n("Hel I o"); 

else 

System, out.pri n 11 n ( "Good bye"); 

This example has a dangling else problem. The Java compiler matches an else 
with the previous unmatched if, so the compiler will interpret the statement 
by matching the else with the inner if ( if (x < z) ), whether you use indentation 
style A or B. If you want to express the logic of indentation style A, you have to 
express it as 

if (x < y) { 

if (X < 2 ) 

System, out. pri ntl n("Hel I o"); 

} else 

System, out. pri ntl n ( "Good bye"); 


Indentation style A 


Indentation style B 
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This dangling else problem is another reason why we recommend that beginners 
use the syntax for <compound statement in the then and else blocks. In other 
words, always use the braces in the then and else blocks. 

Let’s conclude this section by including tests inside the add and deduct methods 
of the Account class from Chapter 4. For both methods, we will update the balance 
only when the amount passed is positive. Furthermore, for the deduct method, we will 
update the balance only if it does not become a negative number after the deduction. 
This will require the use of a nested if statement. The following is the class declaration. 
The name is Ch5Account, and this class is based on AccountVer2 from Chapter 4. We 
only list the two methods here because other parts are the same as in AccountVer2. 


class Ch 5 Ac count { 


II Adds the passed amount to the balance 

public void a d d ( d o u b I e amt) { 

II add if amt is positive; otherwise, do nothing 

if ( a mt > 0 ) { 

balance = balance + amt; 

} 


L. 


add 


Deducts the passed amount from the balance 


c 

void 

ded 

uct ( 

do 

u b 1 e a mt 

) 

{ 





/( 

deduct 

i f 

a mt 

i 

s positi 

ve 

; do 

n 

ot 

hi 

ng 

f 

( a mt 

> 0 

) { 










doub 

1 e 

newb 

a 1 

ance = b 

a 1 

ance 


a 

mt 

; 


if ( 

new 

ba 1 a 

nc 

e >= 0) 

{ 

III 

f 

a 

n 

ew 



ba 

lane 

e 

= newbal 

a n 

ce; / 

/ 

up 

da 

t e 


} 






II 

d 

0 

no 

t h 


c 


deduct 


Quick 

CHECK 


1. Rewrite the following nested if statements without using any nesting. 

a. i f ( a < c ) 

i f ( b < c ) 
x = y; 
else 

x = z; 
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boolean 

operator 


else 

x = z; 

b. i f ( a == b ) 

x = y; 

else 

i f ( a > b ) 
x = y; 
else 

x = z; 

c. i f ( a < b ) 

i f ( a >= b ) 
x = z; 
else 
x = y; 

else 

x = z; 

2. Format the following if statements with indentation. 

a. i f ( a < b )if(c>d)x=y; 
e I s e x = z; 

b. i f ( a < b ) { i f ( c > d ) x = y; } 
else x = z; 

c. if( a <b ) x = y; i f ( a <c ) x = z; 
else if( c <d ) z = y; 

5.3 Boolean Expressions and Variables 

In addition to the arithmetic operators introduced in Chapter 3 and relational oper¬ 
ators introduced in Section 5.2, boolean expressions can contain conditional and 
boolean operators. A o lean operator, also called a logical operator, takes boolean 
values as its operands and returns a boolean value. Three boolean operators are 
AND, OR, and NOT. In Java, the symbols &&, II, and ! represent the AND, OR, and 
NOT operators, respectively. Table 5.1 explains how these operators work. 

The AND operation results in true only if both P and Q are true. The OR op¬ 
eration results in true if either P or Q is true. The NOT operation is true if A is false 
and is false if P is true. Combining boolean operators with relational and arithmetic 
operators, we can come up with long boolean expressions such as 

(x + 150) == y || x < y && !(y < z && z < x) 

( x < y ) && ( a == b || a == c ) 
a ! = 0 && b ! = 0 && ( a + b < 10) 

In Section 5.1 we stated that we can reverse the relational operator and switch 
the then and else blocks to derive the equivalent code. For example, 

if (age < 0) { 

System, out, p r i n 11 n ( " Invalid age is entered"); 

} else { 

System, out, p r i n 11 n ( " Valid age is entered"); 

} 
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is equivalent to 

if ( ! (age < 0) ) { 

System, out, p r i n 11 n ( " Valid age is entered"); 

} else { 

System, out. p r i n 11 n ( " Invalid age is entered' 1 ); 

} 

which can be written more naturally as 
if (age >= 0) { 

System, out, p r i n 11 n ( " Valid age is entered"); 

} else { 

System, out, p r i n 11 n ( " Invalid age is entered"); 

} 

Reversing the relational operator means negating the boolean expression. 
In other words, !(age < 0) is equivalent to (age >= 0). Now, consider the following 
if-then-else statement: 

if (temperature >= 65 && di stanceToDesti nati on < 2) { 
System, out. pri ntl n("Let' s wa I k" ) ; 

} else { 

System, out. pri ntl n ( " L e t 1 s drive"); 

} 

If the temperature is greater than or equal to 65 degrees and the distance to 
the destination is less than 2 mi., we walk. Otherwise (it’s too cold or too far 
away), we drive. How do we reverse the if-then-else statement? We can rewrite 
the statement by negating the boolean expression and switching the then and else 
blocks as 

if ( ! ( temperature >= 65 && di stanceToDesti nati on < 2) ) { 
System, out, pri ntl n (" Let's drive"); 

} else { 

System, out. pri ntl n (" L e t' s wa I k" ) ; 

} 
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or more directly and naturally as 

if (temperature < 65 || di stanceToDesti nati on >= 2) { 
System, out. pri ntl n ( "Let 1 s dri v e" ); 

} else { 

System, out, pri ntl n ( " L et ' s wa I k" ) ; 

} 

The expression 

((temperature >= 65 && di stanceToDesti nati on < 2) 
is equivalent to 

((temperature >= 65) || ! (di stanceToDesti nation < 2) 
which, in turn, is equivalent to 

(temperature < 65 || di stanceToDesti nati on >= 2) 

The logical equivalence is derived by applying the following DeMorgan’s law: 

Rule 1: ! (p && q) < > ip | | IQ 
Rule 2: i(p || q) < > ip && IQ 

-Equivalence symbol 


Table 5.2 shows their equivalence. 

Now consider the following expression: 

x / y > z | | y == 0 

What will be the result if y is equal to 0? Easy, the result is true, many of you might 
arithmetic say. Actually a runtime error called an arithmetic exception will result, because the 

exception expression 

x / y 


Table 5.2 The truth table illustrating DeMorgan's law 


p 

Q 

!(P&&Q) 

!P 11 !Q 

!(P | | Q) 

!P && !Q 

false 

false 

true 

true 

true 

true 

false 

true 

true 

true 

false 

false 

true 

false 

true 

true 

false 

false 

true 

true 

false 

false 

false 

false 
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divide-by-zero 

error 


short-circuit 

evaluation 


causes a problem known as a divide-by-zero error. Remember that you cannot divide 
a number by zero. 

However, if we reverse the order to 

y == 0 || x / y > z 

then no arithmetic exception will occur because the test x / y > z will not be evalu¬ 
ated. For the OR operator II, if the left operand is evaluated to true, then the right 
operand will not be evaluated, because the whole expression is true, whether the 
value of the right operand is true or false. We call such an evaluation method a 
short-circuit evaluation. For the AND operator &&, the right operand need not be 
evaluated if the left operand is evaluated to false, because the result will then 
be false whether the value of the right operand is true or false. 

Just as the operator precedence rules are necessary to evaluate arithmetic 
expressions unambiguously, they are required for evaluating boolean expressions. 
Table 5.3 expands Table 3.3 by including all operators introduced so far. 

In mathematics, we specify the range of values for a variable as 

80 < x <90 

In Java, to test that the value for x is within the specified lower and upper bounds, 
we express it as 

80 <= x && x < 90 

You cannot specify it as 

80 <= X < 90 Wrong 

This is a syntax error because the relational operators (<, <=, etc.) are binary 
operators whose operands must be numerical values. Notice that the result of the 
subexpression 

80 <= x 

is a boolean value, which cannot be compared to the numerical value 90. Their data 
types are not compatible. 

The result of a boolean expression is either true or false, which are the two 
values of data type boolean. As is the case with other data types, a value of a data 
type can be assigned to a variable of the same data type. In other words, we can 
declare a variable of data type boolean and assign a boolean value to it. Here are 
examples: 

boolean pass, done; 

pass = 70 < x; 
done = true; 

One possible use of boolean variables is to keep track of the program settings 
or user preferences. A variable (of any data type, not just boolean) used for this 
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Operator precedence rules. Groups are listed in descending order of prece- 
Table 5.3 dence. An operator with a higher precedence will be evaluated first. If two 
operators have the same precedence, then the associativity rule is applied 


Group 

Operator 

Precedence 

Associativity 

Subexpression 

( ) 

10 

Left to right 



(If parentheses are nested, 
then innermost subexpres- 




sion is evaluated first.) 


Postfix 

increment and 

decrement 

operators 

++ 

9 

Right to left 

Unary 

operators 

J 

8 

Right to left 

Multiplicative 

* 

7 

Left to right 

operators 

/ 




% 



Additive 

operators 

+ 

6 

Left to right 

Relational 

< 

5 

Left to right 

operators 

< = 

> 



Equality 

> = 

4 

Left to right 

operators 

J - 



Boolean AND 

&& 

3 

Left to right 

Boolean OR 

| | 

2 

Left to right 

Assignment 

= 

1 

Right to left 


purpose is called a ag. Suppose we want to allow the user to display either short 
or long messages. Many people, when using a new program, prefer to see long 
messages, such as Enter a person's age and press the Enter key to continue. But 
once they are familiar with the program, many users prefer to see short messages, 
such as Enter age. We can use a boolean flag to remember the user’s preference. We 
can set the flag longMessageFormat at the beginning of the program to true or false 
depending on the user’s choice. Once this boolean flag is set, we can refer to the 
flag at different points in the program as follows: 

if (longMessageFormat) { 

//display the message in long format 
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} else { 

//display the message in short format 

} 

Notice the value of a boolean variable is true or false, so even though it is 
valid, we do not write a boolean expression as 


i f 

(isRaining 

= = 

true) 

{ 



Syst em. out. 

p r i 

nt 1 n ( 

"Store 

is open"); 

} 

else { 






Syst em. out. 

p r i 

nt 1 n ( 

"Store 

is closed" 


} 


but more succinctly as 

if (isRaining) { 

System, out. pri ntl n("Store is open"); 

} else { 

System, out. pri ntl n("Store is closed"); 

} 

Another point that we have to be careful about in using boolean variables is 
the choice of identiher. Instead of using a boolean variable such as motionStatus, it 
is more meaningful and descriptive to use the variable isMoving. For example, the 
statement 


if ( i s Movi n g ) { 

II the mo bile robot is moving 

} else { 

II the mo bile robot is not moving 

} 

is much clearer than the statement 


if (moti onStatus) { 

II the mo bile robot is moving 

} else { 

II the mo bile robot is not moving 

} 


When we define a boolean data member for a class, it is a Java convention to 
use the prefix is instead of get for the accessor. 

We again conclude the section with a sample class. Let’s improve the 
Ch5Account class by adding a boolean data member active to represent the state of 
an account. When an account is first open, it is set to an active state. Deposits and 
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withdrawals can be made only when the account is active. If the account is inactive, 
then the requested opertion is ignored. Here’s how the class is defined (the actual 
class name is Ch5AccountVer2): 



class Ch5AccountVer 2 { 

II Data Me mbe r s 
private String owne r Na me; 

private double balance; 

private boolean active; 

//Constructor 

public Ch5AccountVer2(Stri ng name, 

o wn e r Na me = n a me; 
balance = starti ngBal ance; 

setActi ve(true); 

} 


Data Members 


double starti ngBal ance ) { 


//Adds the passed amount to the balance 

public void add(doub) e amt) { 

//add If amt is positive; do nothing otherwise 
if (i s Ac t i v e ( ) && a mt > 0 ) { 
balance = balance + amt; 

} 

} 


II Closes the account; set 'active' to false 

public void cl o s e ( ) { 

set Acti ve ( f al se) ; 

} 


//Deducts the passed amount fromthe balance 

public void deduct ( doubl e amt) { 

II deduct If amt is positive; do nothing otherwise 

if ( i s Ac t i v e ( ) && a mt > 0 ) { 

double newbalance = balance - amt; 


c 


add 



if (newbalance >= 0) { //don't let the balance become negative 
balance = newbalance; 

} 

} 

} 
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//Returns the current balance of this account 

public double get Curr entBal a n c e ( ) { 
return balance; 

} 

//Returns the name of this account's owner 

public String get Owner Name( ) { 

return ownerName; 

} 

II Is the account active? 

public boolean i sActi ve ( ) { 
return active; 

} 

II Assigns the name of this account's owner 

public void setOwnerName ( Str i ng name) { 

o wn e r Na me = n a me; 

} 

II Sets 'active' to true or false 

private void setActi ve ( boolean state) { 

active = state; 

} 

} 


( \ 

getCurrentBalance 


getOwnerName 



setOwnerName 


setActive 


Quick 

CHECK 

V 


1. Evaluate the following boolean expressions. Assume x, y, and z have some 
numerical values. 

a. 4 < 5 | | 6 == 6 

b. 2 < 4 && (false || 5 <= 4 ) 

c. x<=y&&!(z!=z) || x > y 

d. x < y | | z < y && y <= z 

2. Identify errors in the following boolean expressions and assignments. Assume 
x and y have some numerical values. 

a. boolean done; 
done = x = y; 

b. 2 <4 && ( 3 < 5 ) + 1 == 3 

c. boolean quit; 
quit = t r ue ; 

quit ==(34 == 20 ) && quit; 
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We introduced the logical AND and OR operations using the symbols && and ||. 
In Java, there are single ampersand and single vertical bar operations. For exam¬ 
ple, if we write an if statement as 

if ( 70 <= x & x < 90 ) 

it will compile and run. Unlike the double ampersand, the single ampersand will 
not do a short-circuit evaluation. It will evaluate both left and right operands.The 
single vertical bar works in an analogous manner. So, which one should we use? 
Use double ampersand for AND and double vertical bars for OR. We will most 
likely never encounter a situation where we cannot use the double ampersand or 
the double vertical bars. 


5.4 


Comparing Objects 


With primitive data types, we have only one way to compare them, but with objects 
(reference data type), we have two ways to compare them. We discuss the ways 
the objects can be compared in this section. First, let’s review how we compare 
primitive data types. What would be the output of the following code? 


i n t n u ml, 

n u m2 

I 



n u ml = 15; 





n u m2 = 15; 





if ( n u ml = 

= nu 

m2) { 



System. 

out. 

p r i n 11 n ( 

"They 

are equal" 

} else { 





System, 

out. 

p r i n 11 n ( 

"They 

are not eq 


} 


Because the two variables hold the same value, the output is 
They are equal 

Now, let’s see how the objects can be compared. We will use String objects for 
illustration. Since we use string data all the time in our programs, it is very impor¬ 
tant for us to understand perfectly how String objects can be compared. 

Consider the following code that attempts to compare two String objects: 


St 

ring 

st r 1 

, st r 2 


s t 

rl = 

new 

S t r i n g 

("J 

st 

r 2 = 

new 

S t r i n g 

(" J 

i f 

( st r 

1 = = 

st r2 ) 

{ 


Syst 

e m. o 

u t. p r i 

nt 1 


a v a" ); 
a v a" ); 

n ( "They are equal"); 
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} else { 

System, out. p r i n 11 n ( "They are not equal"); 

} 


What would be an output? The answer is 
They are not equal 

The two objects are constructed with the same sequence of characters, but the result 
of comparison came back that they were not equal. Why? 

When two variables are compared, we are comparing their contents. In the 
case of primitive data types, the content is the actual value. In case of reference data 
types, the content is the address where the object is stored. Since there are two dis¬ 
tinct String objects, stored at different addresses, the contents of str 1 and str2 are 
different, and therefore, the equality testing results in false. If we change the code to 


St 

ring 

strl, st 

r 2 

1 


St 

rl = 

new St r i 

ng 

("J 

a va 11 

St 

r 2 = 

strl; 




i f 

(str 

1 == str 

2) 

{ 



Syst 

em, out. p 

r i 

nt 1 

n ( ” T 

} 

else 

{ 





Syst 

e m. o u t. p 

r i 

nt 1 

n ( ” T 


} 


then the output would be 
They are equal 


' 1 No new object is created here.The content 
(address) of strl is copied to str2, making 
them both point to the same object. 

hey are equal"); 
hey are not equal"); 


because now we have one String object and both variables strl and str2 point to this 
object. This means the contents of strl and str2 are the same because they refer to 
the same address. Figure 5.5 shows the distinction. 

What can we do if we need to check whether two distinct String objects have 
the same sequence of characters? Many standard classes include different types 
of comparison methods. The String class, for example, includes the equals and 
equalsIgnoreCase comparison methods. The equals method returns true if two String 
objects have the exact same sequence of characters. The equalsIgnoreCase method 
does the same as the equals method, but the comparison is done in a case-insensitive 
manner. Using the equals method, we can rewrite the first sample code as 


St 

r i 

ng 

strl 

r 

st 

r 2 

1 




st 

r 1 

= 

new 

St 

r i 

ng 

(" 

j a v 

a" ) 

‘ 

st 

r 2 

= 

new 

St 

r i 

ng 

(" 

j a v 

a" ) 

1 

i f 

( 

str 

1. eq 

ua 

1 s 

( s 

t r 

2)) 

{ 



S 

yst 

em, o 

ut 

■ P 

r i 

nt 

1 n ( 

" Th 

e y are equal" 

} 

el 

se 

{ 









S 

yst 

e m. o 

ut 

■ P 

r i 

nt 

1 n ( 

" Th 

ey are not eq 


} 


Use the equals 
method. 
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Case A: Two variables refer to two different objects. 


strl str2 



String strl, str2; 

strl = new String("Java") ; 
str2 = new String("Java") ; 


strl = = str2 —► false 


Case B: Two variables refer to the same object, 
strl str2 



String strl, str2; 

strl = new String("Java") ; 
str2 = strl; 


strl = = str2 —► true 


Figure 5.5 How the equality == testing works with the objects. 


and get the result 

They are equal 

Just as the String and many standard classes provide the equals method, it is 
common to include such an equals method in programmer-defined classes also. 
Consider a Fraction class. We say two Fraction objects are equal if they have the 
same value for the numerator and the denominator. Here’s how we can define the 
equals method for the Fraction class: 

class Fraction { 

private int numerator; 
private int denominator; 


//constructor and other methods 


public int get Numerat or ( ) { 
return numerator; 

} 
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public i nt get Denomi nat or ( ) { 
return denominator; 

} 

public boolean equal s(Fracti on number) { 

return (numerator == number. get Numerator( ) 

&& denominator == number. get Denomi nat or ()) ; 

} Compare this object's values to the 

} values of number 

Notice that the body of the equals method is a concise version of 

if (numerator == number, get Numerator! ) 

&& denominator == number. get Denomi nat or ()) { 

return true; 

} else { 

return false; 

} 

Using the equals method, we can compare two Fraction objects in the follow¬ 
ing manner: 

Fraction fracl, f r a c 2; 

II create fracl and f r a c 2 objects 


if ( f r a c 1,equaI s ( f r ac 2 ) ) { 

} 

or equivalently as 

if (frac2.equal s(fracl)) { 

} 

Note that the equals method as defined is incomplete. For example, if we 
compare fractions 4/8 and 3/6, using this equals method, we get false as the result 
because the method does not compare the fractions in their simplified form. The 
method should have reduced both 4/8 and 3/6 to 1/2 and then compared. To 
implement a method that reduces a fraction to its simplest form, we need to use a 
repetition control statement. We will revisit this problem when we learn how to 
write repetition control statements in Chapter 6. Also, we will provide the complete 
definition of the Fraction class in Chapter 7. 

We conclude this section by presenting an exception to the rule for comparing 
objects. This exception applies to the String class only. We already mentioned in 
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Chapter 2 that for the String class only, we do not have to use the new operator to 
create an instance. In other words, instead of writing 

String str = new String! "Java"); 

we can write 

String str = "Java"; 

which is a more common form. These two statements are not identical in terms 
of memory allocation, which in turn affects how the string comparisons work. 
Figure 5.6 shows the difference in assigning a String object to a variable. If we do 
not use the new operator, then string data are treated as if they are a primitive data 
type. When we use the same literal String constants in a program, there will be 
exactly one String object. 

This means we can use the equal symbol == to compare String objects when 
no new operators are used. However, regardless of how the String objects are cre¬ 
ated, it is always correct and safe to use the equals and other comparison methods 
to compare two strings. 


hings to Remember 



Always use the equals and other comparison methods to compare String objects. 
Do not use == even though it may work correctly in certain cases. 


String wordl, word2; 
wordl = new string!"Java") ; 
word2 = new string! "Java") ; 


wordl 


word2 



Whenever the new operator is used, 
there will be a new object. 


:String 


Java 



wordl == word2 ■ 


false 


String wordl, word2; 


wordl 


word2 


wordl = "Java"; 
word2 = "Java"; 

( " " " \ 

Literal string constant such as “Java” will 

always refer to one object. 

wordl == word2 



Figure 5.6 Difference between using and not using the new operator for String. 
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Quick 

CHECK 

1. Determine the output of the following code. 

String s t r 1 = “Java"; 

String s t r 2 = “Java"; 

boolean resultl = strl == s t r 2 ; 
boolean r e s u 11 2 = str1. equa 1 s ( str2 ); 

System, out. pri ntl n(resultl); 

System, out. pri ntl n(result2); 

2. Determine the output of the following code. 

String strl = new String!“latte"); 

String s t r 2 = new String) 11 LATTE" ) ; 

boolean resultl = strl == s t r 2 ; 
boolean r e s u 11 2 = str 1 .e q ua 1 s ( str2 ); 

System, out. pri ntl njresul tl); 

System, out. pri ntl njresul t2); 

3. Show the state of memory after the following statements are executed. 

String strl, s t r 2, s t r 3; 
strl = " J a s mi n e " ; 
st r 2 = " 0 o 1 ong " ; 
st r 3 = st r 2; 
st r 2 = strl; 

switch 

statement 

5.5 The switch Statement 

Another Java statement that implements a selection control flow is the switch 
Statement. Suppose we want to direct the students to the designated location for 
them to register for classes. The location where they register is determined by their 
grade level. The user enters 1 for freshman, 2 for sophomore, 3 for junior, and 4 for 
senior. Using the switch statement, we can write the code as 

int gr adeLevel ; 

Scanner scanner = new Scanner ( System, in); 

System, out. print! "Grade (Frosh-l,Soph-2,...): "); 

gradeLevel = scanner. next 1 nt ( ); 

switch (gradeLevel) { 

case 1: System, out. pri ntl n("Go to the Gymnasium"); 

break; 

case 2: System, out. pri ntl n("Go to the Science Auditorium"); 

break; 
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case 3: System, out. pri ntl n("Go to Halligan Hall R m 10 4"); 

break; 

case 4: System, out. pri ntl n("Go to Root Hall Rm 101"); 

break; 

} 

The syntax for the switch statement is 

switch switch ( cinteger expression ) { 

statement 

syntax <c a s e label 1> : <c a s e body 1> 

<c a s e label n> : <c a s e body n> 

} 

Figure 5.7 illustrates the correspondence between the switch statement we wrote 
and the general format. 

The <case label i> has the form 

default case cinteger constant > or default 

reserved word 

and <case body i> is a sequence of zero or more statements. Notice that <case body i> 
is not surrounded by left and right braces. The <constant> can be either a named or 
literal constant. 

The data type of carithmetic expression> must be char, byte, short, or int. 
C Note: We will cover the data type char in Chap. 9.) The value of carithmetic 
expression> is compared against the constant value i of cease label i>. If there is a 


Integer I 
Expression [ 


switch ( ' gradeLevel J ) { 


CB - case body 
CL - case label 


CL1 


CL2 


CL3 


CL4 



case i : 'j 


case 2 : 'j 


case 3: 'j 


case 4 : 'j 


} 


' System.out.println("Go to the Gymnasium"); 

; break; 


i System.out. println( "Go to the Science Auditorium") 

1 break; 


' System.out.println("Go to Halligan Hall Rm 104"); 

1 break; 


\ System.out. println( "Go to Root Hall Rm 101"); 

1 break; 



CB1 


CB2 


CB3 


CB4 


Figure 5.7 Mapping of the sample switch statement to the general format. 
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break 

statement 


matching case, then its case body is executed. If there is no matching case, then 
the execution continues to the statement that follows the switch statement. No two 
cases are allowed to have the same value for <constant>, and the cases can be 
listed in any order. 

Notice that each case in the sample switch statement is terminated with the 
break statement. The break statement causes execution to continue from the state¬ 
ment following this switch statement, skipping the remaining portion of the switch 
statement. The following example illustrates how the break statement works: 


ss ume 

ne 

cess 

a r y 

dec 

1 ar 

a t i 

on 

a n 

ec t i o 

n = 

1; 







tch ( 

s el 

ec t i 

on) 

{ 





case 

0: 

Syst 

e m, 

out 

P r i 

nt 1 

n ( 

0): 

case 

1: 

Syst 

e m, 

out 

p r i 

nt 1 

n ( 

1): 

case 

2: 

Syst 

e m, 

out 

P r i 

nt 1 

n ( 

2): 

case 

3: 

Syst 

e m, 

out 

p r i 

nt 1 

n ( 

3): 


} 


When this code is executed, the output is 


1 

2 

3 


because after the statement in case 1 is executed, statements in the remaining cases 
will be executed also. To execute statements in one and only one case, we need 
to include the break statement at the end of each case, as we have done in the first 
example. Figure 5.8 shows the effect of the break statement. 

The break statement is not necessary in the last case, but for consistency we 
place it in every case. Also, by doing so we don’t have to remember to include the 
break statement in the last case when we add more cases to the end of the switch 
statement. 

Individual cases do not have to include a statement, so we can write some¬ 
thing like this: 

Scanner scanner = new Scanner ( System, in); 

System, out. pri nt("l nput: " ) ; 
int ranking = scanner, n ex 11 nt () ; 
switch (ranking) { 


case 

10: 




case 

9: 




case 

8: 

System, out. pri 

break; 

nt 1 n( 

"Master" ) ; 

case 

7: 




case 

6: 

System, out. pri 

break; 

nt 1 n( 

" J o u r n e y ma n 
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Figure 5.8 A diagram showing the control flow of the switch statement with and without the break statements. 


case 5: 

case 4: System, out. pri ntl n(" Apprentice"); 

break; 

} 

The code will print Master if the value of ranking is 10, 9, or 8; Journeyman if the 
value of ranking is either 7 or 6; or Apprentice if the value of ranking is either 5 or 4. 

We may include a default case that will always be executed if there is no 
matching case. For example, we can add a default case to print out an error message 


if any invalid value for ranking is entered. 

switch l 

ranking) { 

case 

10: 

case 

9: 

case 

8 : System, out. pri ntl n("Master"); 

break; 

case 

7: 

case 

6: System, out. pri ntl n(" journey man 

break; 


case 5: 
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defensive 

programming 



Quick 

CHECK 


case 4: System, out. p r i n 11 n ( " Apprentice"); 

break; 


d e f a u I t 


} 


System, out, pri nt 

break; 


"Error: Invalid Data"); 


There can be at most one default case. Since the execution continues to the next 
statement if there is no matching case (and no default case is specified), it is safer to 
always include a default case. By placing some kind of output statement in the 
default case, we can detect an unexpected switch value. Such a style of program¬ 
ming is characterized as defensive programming. Although the default case does not 
have to be placed as the last case, we recommend you do so, in order to make the 
switch statement more readable. 


1. What’s wrong with the following switch statement? 


switch ( N ) 
case 0: 
case 1: 

default: 

case 2: 

case 1: 


{ 

x = 11; 

break; 

System, out, pri 

break; 

x = 22; 

break; 

x = 33; 

break; 


S wi t c h 


Error"); 


2. What’s wrong with the following switch statement? 


s wi t c h ( 

r anki ng 

) { 


case 

>4. 55: 

pay = pay * 

break; 

0.20 

case 

=4, 55: 

pay = pay * 

break; 

0.15 

def aul 

t : 

pay = pay * 

break; 

0.05 


5.6 


Drawing Graphics 


We introduce four standard classes related to drawing geometric shapes on a 
window. These four standard classes will be used in Section 5.7 on the sample 
development. We describe their core features here. More details can be found in the 
online Java API documentation. 
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java.awt. 

Graphics 


content pane 
of a frame 


I* 

Cha 


Fi I f 

*1 

i mpor t j 
i mpor t j 

class Cl 

publ 


} 

} 


java.awt.Graphics 

We can draw geometric shapes on a frame window by calling appropriate methods 
of the Graphics object. For example, if g is a Graphics object, then we can write 

g, dr aw Re c t ( 5 0, 5 0, 1 0 0, 3 0 ) ; 

to display a rectangle 100 pixels wide and 30 pixels high at the specified position 
(50, 50). The position is determined as illustrated in Figure 5.9. The complete pro¬ 
gram is shown below. The top left corner, just below the window title bar, is posi¬ 
tion (0, 0), and the x value increases from left to right and the y value increases from 
top to bottom. Notice that the direction in which the y value increases is opposite to 
the normal two-dimensional graph. 

The area of a frame which we can draw is called the content pane of a frame. 
The content pane excludes the area of a frame that excludes the regions such as the 
border, scroll bars, the title bar, the menu bar, and others. To draw on the content 
pane of a frame window, first we must get the content pane’s Graphic object. Then 
we call this Graphics method to draw geometric shapes. Here’s a sample: 


)ter 5 Sample Program: Draw a rectangle on a frame 

window's content pane 



Ch5S 

a mp 1 

e G r a p h 

i c s. j 

a v a 




a v 

a x. s 

wi ng 

. * ; II 

for j 

F r a me 




a v 

a. a wt. *; 

II for 

Gr a p 

hi cs ; 

j nd Con 

t a i 

n e r 

5 S 

a mp 1 

e G r a 

phi cs 

{ 





i c 

st a 

t i c 

void ma i n ( 

St ri ng [ ] a r g 

s ) 

{ 

J F 

r a me 


wi n; 






Co 

nt a i 

n e r 

c o n t e n 

t Pa ne 

; 




Gr 

a p h i 

c s 

g; 






wi 

n = 

new 

J F r a me 

( " My 

First 

Re c t a n 

gl e 

11 ); 

wi 

n. s e 

t Si z 

e ( 300, 

2 0 0 ) 

J 




wi 

n. s e 

t Loc 

a t i o n ( 

100, 1 

00) ; 




wi 

n. s e 

t Vi s 

i b 1 e ( t 

rue); 





C 0 

nt e n 

t Pan 

e = wi 

n. get 

Co nt e r 

it Panel 

); 


g 

= c 0 

nt e n 

t Pane. 

get Gr 

aphi c: 

i (); 



g. 

d r a wRec t 

(50,50 

, 100, 

30); 





win must be visible on the 
screen before you get its 
content pane. 
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Syntax 

A rectangle <width> 
wide and <height> 
high is displayed at 
position (<x>, <y>). 


graphic. drawRect( <x>, <y>, <width>, <height>) ; 


Example: 


graphic. drawRect( 50, 50, 100, 30); 


+x 



Position (0. 0) 


Figure 5.9 The diagram illustrates how the position of the rectangle is determined by the drawRect method. 


Here are the key points to remember in drawing geometric shapes on the con¬ 
tent pane of a frame window. 



{ ings to Remember 

To draw geometric shapes on the content pane of a frame window: 

1. The content pane is declared as a Container, for example, 

Container contentPane; 

2. The frame window must be visible on the screen before we can get its content 
pane and the content pane's Graphics object. 



Depending on the speed of your PC, you may have to include the following try 
statement 

try {Thread, si eep(200);} catch (Exception e) {} 

to put a delay before drawing the rectangle. Place this try statement before the 
last statement.The argument in the sleep method specifies the amount of delay 
in milliseconds (1000 ms = 1 s). If you still do not see a rectangle drawn in the 
window after including the delay statement, increase the amount of delay until 
you see the rectangle drawn. We will describe the try statement in Chapter 8. 
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G 




| Oil 

Might 
Want to 
Know 


If there is a window that covers the area in which the drawing takes place or the draw¬ 
ing window is minimized and restored to its normal size, the drawn shape (or portion of 
it, in the case of the overlapping windows) gets erased.The DrawingBoard class used in 
the sample development (Sec. 5.7) eliminates this problem. For information on the 
technique to avoid the disappearance of the drawn shape, please check our website at 
www.mhhe.com/wu 


Table 5.4 lists some of the available graphic drawing methods. 


Table 5.4 A partial list of drawing methods defined for theGr a phi cs class 


Method 


Meaning 


drawLi ne(xl, yl,x2, y2) 


dr awRect ( x, y, w, h ) 


drawRoundRectfx, y, w, h, aw, ah) 


Draws a line between ( x 1, y 1) and 

(x2,y2) . 


(xl.yl) ’ 

Draws a rectangle with width w and height h 

at ( x, y) . 

(x.y) 


Draws a rounded-corner rectangle with 
width w and height h at ( x , y ) . Parameters 
aw and a h determine the angle for the 
rounded corners. 

(x.y) 


ah I 
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Table 5.4 A partial list of drawing methods defined for the Gr a phi cs class (Continued) 


Notice the distinction between the draw and fill methods. The draw method 
will draw the boundary only, while the fill method fills the designated area with the 
currently selected color. Figure 5.10 illustrates the difference. 


java.awt.Color 

To designate the color for drawing, we will use the Color class from the standard 
java.awt.Color java.awt package. A Color object uses a coloring scheme called the RGB scheme, 
which specifies a color by combining three values, ranging from 0 to 255, for red, 
green, and blue. For example, the color black is expressed by setting red, green, 
and blue to 0, and the color white by setting all three values to 255. We create, for 
example, a Color object for the pink color by executing 

Col or pi nkCol or; 

pinkColor = new Co I o r ( 2 5 5, 1 7 5, 1 7 5 ); 
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g.drawRectf 50, 


50, 100, 30); 



g. fillRect( 175, 50, 100, 
/ 


My First Rectangle 



30) ; 


Figure 5.10 The diagram illustrates the distinction between the draw and fill methods. We assume the 
currently selected color is black (default). 


Instead of dealing with the three numerical values, we can use the public class 
constants defined in the Color class. The class constants for common colors are 


Col 

or. BLACK 

Col 

or. MAGENTA 

Col 

or. BLUE 

Col 

or. ORANGE 

Col 

or. CYAN 

Col 

or. PI NK 

Col 

or. DARK GRAY 

Col 

or. RED 

Col 

or. GRAY" 

Col 

o r. WH1 T E 

Col 

or. GREEN 

Col 

or.YELLOW 

Col 

or. LI GHT GRAY 




The class constants in lowercase letters are also defined (such as Color.black, 
Col or. blue, and so forth). In the older versions of Java, only the constants in 
lowercase letters were defined. But the Java convention is to name constants using 
only the uppercase letters, so the uppercase color constants are added to the class 
definition. 

Each of the above is a Color object with its RGB values correctly set up. We 
will pass a Color object as an argument to the setColor method of the Graphics class 
to change the color. To draw a blue rectangle, for example, we write 

/ / As s u me g is set correctly 

g, set Col or ( Col or. BLUE); 

g, dr awRect ( 5 0, 5 0, 1 0 0, 3 0 ) ; 

We can also change the background color of a content pane by using the 
setBackground method of Container as 

contentPane, setBackground(Col or. LI GHT_GRAY); 
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Figure 5.11 A frame with a white background content pane and two rectangles. 


Running the following program will result in the frame shown in Figure 5.11. 


/ * 

Chapter 5 Sample Program: Draw one blue rectangle and 

one filled red rectangle on light gray 
background content pane 

File: Ch5Sampl eGraphi cs2.j ava 

*/ 

import j avax. swi ng. *; 
i mpo r t j a v a. a wt. *; 

class Ch5Sampl eGraphi cs2 { 

public static void mai n ( String!] args ) { 

j F r a me wi n; 

Cont ai ner cont ent Pane; 

Gr aphi cs g; 

wi n = new JFrame("Rectangles"); 
wi n. setSi ze( 300, 200); 
wi n. setLocati on( 100, 100); 
wi n. setVi si bl e(true); 

contentPane = wi n. getContentPane (); 
contentPane, setBackground(Col or. LI GHT_GRAY); 

g = contentPane. getGraphi cs(); 
g. set Col or ( Col or. BLUE); 
g. dr awRect ( 5 0, 5 0, 1 0 0, 3 0 ) ; 
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g, set Col or ( Col or, RED); 
g,fiI I Rect ( 1 7 5, 5 0, 1 0 0, 3 0 ); 

} 

} 


java.awt.Point 

A Point object is used to represent a point in two-dimensional space. It contains x 
and y values, and we can access these values via its public data member x and y. 
Here’s an example to assign a position (10, 20): 

Point pt = new Pol nt () ; 
pt. x = 10; 
pt. y = 20; 

It is also possible to set the position at the creation time as follows: 

Pol nt pt = new Point (10, 20); 


java.awt.Dimension 

In manipulating shapes, such as moving them around a frame’s content pane, the 
concept of the bounding rectangle becomes important. A bounding rectangle is a 
rectangle that completely surrounds the shape. Figure 5.12 shows some examples of 
bounding rectangles. 

Just as the (x, y) values are stored as a single Point object, we can store the width 
and height of a bounding rectangle as a single Dimension object. The Dimension class 
has the two public data members width and height to maintain the width and height 
of a bounding rectangle. Here’s an example to create a 40 pixels by 70 pixels high 
bounding rectangle: 

Dimension dim = new Dimension!); 
di m. wi dt h = 4 0; 
dim. height = 70; 



I I Bounding rectangle 
- — -I of a rectangle is the 
j rectangle itself. 


Bounding rectangle 



Figure 5.12 Bounding rectangles of various shapes. 
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Figure 5.13 Sample output of Ch5RoomWinner program. 


It is also possible to set the values at the creation time as follows: 

Dimension dim = new Di mensi on(40, 70); 

Let’s apply the drawing techniques to an early sample program. In Chapter 4, 
we wrote the RoomWinner program that randomly selects and displays the dorm 
room lottery cards. The display was only in text, something like this: 


Wi nni 

ng 

Card Combi 

n a t i 

o n: 

1 - r 

ed 

2 - green 

; 3 

- bl 



color 

n u 

mbe r 

Car d 

1: 

2 


13 

Car d 

2: 

2 


12 

Car d 

3: 

1 


14 


We will make a graphical version of the program. Figure 5.13 shows a sample 
output. 

Here’s the main class Ch5RoomWinner, which has a structure similar to the 
one for Ch5SampleGraphics2. 


► 


mpor t 

java 

mpor t 

java 

lass 

C h 5 R o 

pu 

bl i c 


J Fr 


Con 


Gr a 


a wt. 

*; 


. s wi 

ng 

*; 

mWi n 

ner { 

t at i 

c 

void ma 

me 


wi n; 

ai ne 

r 

content 

hies 


g; 


( String!] a r g s 
ne; 


{ 
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Graphi cLotteryCard one, two, three; 

wi n = new JFrame("Room Winner"); 
wi n. setSi ze( 300, 200); 
wi n. setLocati on ( 1 0 0, 100); 
wi n. setVi si bl e(true); 

contentPane = wi n, getContentPane () ; 
contentPane. set Background( Col or. WHITE); 

g = contentPane. getGraphi cs(); 

one = new Graphi cLotteryCard ( ); 

two = new Gr a p h i c L o 11 e r y Ca r d ( ); 

three = new Graphi cLotteryCard ( ); 

one, spi n() ; 
t wo. s p i n () ; 
three, spi n(); 


one. draw(g, 10, 20); 
two. draw(g, 5 0, 2 0 ) ; 
three, draw) g, 90, 20); 


These objects will draw themselves 
on g at the specified positions. 


We modify the LotteryCard class from Chapter 4 by adding code that will draw a 
card on a given Graphics context. The name of the new class is GraphicLotteryCard. 
Here’s the class definition (we list only the portions that are new): 



i mpor t j a va, a wt. *; 

class GraphicLotteryCard { 

II Data Members 

//width of this card for drawing 

public static final int WIDTH = 30; 

//height of this card for drawing 

public static final int HEIGHT = 40; 

II the other data members and methods are the same as before 

public void d r a w( Gr a p h i c s g, int xOrigin, int yOrigin) { 


s wi t c h (color) { 

case 1: g , set Color! Co lor. RED); 

break; 
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} 



case 2: 

g. 

s et Co 1 

or ( 

Col 

or. GREEN); 




br 

e a k; 






case 3: 

g. 

s et Co 1 

or ( 

Col 

or. BLUE); 




br 

e a k; 





} 








9 ■ 

fi11 Rec t ( 

xOr 

i gi n, 

yOr 

i gi 

n, WIDTH, 

HEI GHT); 

9- 

s et Co 1 o r ( 

Col 

o r. WH1 

TE) 

; / 

/draw text 

in whl t 

g. 

d r a wS t r i n 

g( 

"" + n 

u mb 

er, 

x Or 1 g i n + 

Wl D T H/ 4 


This is a quick way to convert a 
numerical value to String 


Notice that the statements in Ch5RoomWinner 

o n e. d r a w( g, 10, 20); 
two. draw( g, 50, 20); 
three. draw(g, 9 0, 2 0 ) ; 

are not as flexible as they can be. If the values for the constant WIDTH and HEIGHT 
in the GraphicLotteryCard class are changed, these three statements could result in 
drawing the card inadequately (such as overlapping cards). The two constants are 
declared public for a reason. Using the WIDTH constant, for example, we can rewrite 
the three statements as 

int card Width = GraphicLotteryCard. WIDTH; 
o n e. d r a w( g, 10, 20); 
two. draw( g, 10 + card Width + 5, 20); 
three, drawl g, 10 + 2*(cardWi dth+ 5), 20); 

The statements will draw cards with a 5-pixel interval between cards. This code will 
continue to work correctly even after the value of WIDTH is modified. 


enumerated 

constants 


5.7 


Enumerated Constants 


We learned in Section 3.3 how to define numerical constants and the benefits of 
using them in writing readable programs. In this section, we will introduce an 
additional type of constant called enumerated constants that were added to the Java 
language from Version 5.0. Let’s start with an example. Suppose we want to define 
a Student class and define constants to distinguish four undergraduate grade 
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enumerated 

type 


levels—freshman, sophomore, junior, 
we can define the grade levels as such: 

and 

senior. Using the numerical constants, 

class St udent { 

public static final i 

nt 

FRESHMAN = 0; 

public static final i 

nt 

SOPHOMORE = 1; 

public static final i 

nt 

J UNI OR = 2; 

public static final i 

nt 

SENI OR = 3; 


} 

With the new enumerated constants, this is how we can define the grade lev¬ 
els in the Student class: 

class St udent { 

public static enum GradeLevel 

{FRESHMAN, SOPHOMORE, JUNIOR, SENIOR} 

} 

The word enum is a new reserved word, and the basic syntax for defining enumer¬ 
ated constants is 

enum enumerated type> { <const ant v a I u e s > } 

where enumerated type> is an identifier and <constant values> is a list of identi¬ 
fiers separated by commas. Notice that for the most common usage of enumerated 
constants, we append the modifiers public and static; but they are not a required part 
of defining enumerated constants. Here are more examples: 

enum Month {JANUARY, FEBRUARY, MARCH, APRIL, 

MAY, JUNE, J ULY, AUGUST, 

SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER} 

enum Gender {MALE, FEMALE} 

enum Ski I I Level {NOVICE, INTERMEDIATE, ADVANCED, EXPERT} 

One restriction when declaring an enumerated type is that it cannot be a local 
declaration. In other words, we must declare it outside of any method, just as for the 
other data members of a class. 

Unlike numerical constants, which are simply identifiers with fixed numerical 
values, enumerated constants do not have any assigned numerical values. They are 
said to belong to, or be members of, the associated enumerated type. For example, 
two enumerated constants MALE and FEMALE belong to the enumerated type 
Gender. {Note: We keep the discussion of the enumerated type to its simplest form 
here. It is beyond the scope of an introductory programming textbook to discuss 
Java’s enumerated type in full detail.) 
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type safety 


Just as with any other data types, we can declare variables of an enumerated 
type and assign values to them. Here is an example (for the sake of brevity, we list 
the enum declaration and its usage together, but remember that the declaration in 
the actual use cannot be a local declaration): 

enum Fruit {APPLE, ORANGE, BANANA} 

Fruit f 1, f 2, f 3; 

, „ _ , . „ „, _ NOTE: The constant value is prefixed 

fl = Fruit A p p F ■ 

by the name of the enumerated type. 

f 2 = Fruit. BANANA; 

f 3 = fl; 

Because variables fl, f2, and f3 are declared to be of the type Fruit, we can only 
assign one of the associated enumerated constants to them. This restriction supports 
a desired feature called type safety. So what is the big deal? Consider the following 
numerical constants and assignment statements: 


final 


nt 

APPLE 

= 1; 

final 


nt 

ORANGE 

= 2; 

final 


nt 

BANANA 

= 3; 

i nt f 

One, 

fTwo, f 

Three 

f One 

= 

AP 

PLE; 


f T wo 

= 

ORANGE; 


fThre 

e 


f One; 



The code may look comparable to the one that uses enumerated constants, but 
what will happen if we write the following? 

f On e = 4 5; 

The assignment is logically wrong. It does not make any sense to assign meaning¬ 
less value such as 45 to the variable fOne if it is supposed to represent one of the 
defined fruit. However, no compiler error will result because the data type of fOne 
is int. The statement may or may not cause the runtime error depending on how the 
variable fOne is used in the rest of the program. In either case, the program cannot 
be expected to produce a correct result because of the logical error. 

By defining an enumerated type, a variable of that type can only accept the 
associated enumerated constants. Any violation will be detected by the compiler. 
This will eliminate the possibility of assigning a nonsensical value as seen in 
the case for the numerical constants. Type safety means that we can assign only 
meaningful values to a declared variable. 

Another benefit of the enumerated type is the informative output values. As¬ 
suming the variables fTwo and f2 retain the values assigned to them in the sample 
code, the statement 

System, out. printing Favorite fruit is " + fTwo); 
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will produce a cryptic output: 

Favorite fruit is 2 

In contrast, the statement 

System, out. p r i n 11 n (" Favorite fruit is " + f 2 ) ; 
will produce a more informative output: 

Favorite fruit is BANANA 

We will describe other advantages of using enumerated types later in the book. 

As shown, when referring to an enumerated constant in the code, we must pre¬ 
fix it with its enumerated type name, for example, 

Fruit f = Fr ui t. APPLE; 

if ( f == Fr uit.ORANGE) { 

System, out. pri ntl n("l like orange, too. 1 '); 

} 


A case label for a switch statement is the only exception to this rule. Instead of 
writing, for example, 

Fruit fruit; 

fruit = , , , ; 

switch (fruit) { 

case Fruit,APPLE: , , ,; 

break; 

case Fruit, ORANGE: , . , ; 

break; 

case Fr ui t. BANANA: . , .; 


we can specify the case labels without the prefix as in 

Fruit fruit; 

fruit = ,,,; 

switch (fruit) { 

case APPLE: . . . ; 

break; 
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case ORANGE: . . 

break; 


} 


case BANANA: , , 

break; 


It is not necessary to prefix the enumerated constant with its enumerated type 
name when it is used as a case label in a switch statement. 



The enumerated type supports a useful method named valueOf. The method 
accepts one String argument and returns the enumerated constant whose value 
matches the given argument. For example, the following statement assigns the enu¬ 
merated constant APPLE to the variable fruit: 

Fruit fruit = Fruit.val ueOf("APPLE"); 

In which situations could the valueOf method be useful? One is the input rou¬ 
tine. Consider the following: 

Scanner scanner = new Scanner(System. in); 

System, out. print! "Enter your favorite fruit " + 

"(APPLE, ORANGE, BANANA): "); 

String fruitName = scanner. next! ); 

Fruit favori teFrui t = Fruit.val ue Of (fruitName); 

Be aware, however, that if you pass a String value that does not match any of the de¬ 
fined constants, it will result in a runtime error. This means if the user enters 
Orange, for example, it will result in an error (the input has to be all capital letters 
to match). We will discuss how to handle such runtime errors without causing the 
program to terminate abruptly in Chapter 8. 

To access the enumerated constants in a programmer-defined class from outside 
the class, we must reference them through the associated enumerated type (assuming, 
of course, the visibility modifier is public). Consider the following Faculty class: 

class Faculty { 

public static enumRank 

{LECTURER, ASSISTANT, ASSOCIATE, FULL} 

private Rank rank; 
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public void set Rank( Rank r) { 
rank = r; 

} 

public Rank get R a n k ( ) { 
return rank; 

} 

} 

Notice how the enumerate type Rank is used in the setRank and getRank methods. 
It is treated just as any other types are. To access the Rank constants from outside of 
the Faculty class, we write 

Facult y. Rank.ASSI STANT 

Faculty. Rank. FULL 

and so forth. Here’s an example that assigns the rank of ASSISTANT to a Faculty 
object: 

Faculty prof = new Faculty!...); 
prof.set Rank! Facul ty. Rank.ASSI STANT); 

And here’s an example to retrieve the rank of a Faculty object: 

Faculty teacher; 

//assume 'teacher' is properly created 

Faculty. Rank rank; 

rank = teacher. getRank!); 


W 

Quick 

C T 


1. Define an enumerated type Day that includes the constants SUNDAY through 
SATURDAY. 

2. What is the method that returns an enumerated constant, given the matching 
String value? 

3. Detect the error(s) in the following code: 

enum Fr ui t {APPLE, ORANGE, BANANA} 

Fruit f 1, f 2; 
i nt f 3; 

f 1 = 1; 
f 2 = ORANGE; 
f 3 = fl; 
f1 = " BANANA"; 
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5.8 Sample Development 


Drawing Shapes 

When a certain period of time passes without any activity on a computers screensaver be¬ 
comes active and draws different types of geometric patterns or textual messages. 
In this section we will develop an application that simulates a screensaver. We will learn a 
development skill very commonly used in object-oriented programming. Whether we 
develop alone or as a project team member, we often find ourselves writing a class that 
needs to behave in a specific way so that it works correctly with other classes. The other 
classes may come from standard Java packages or could be developed by the other team 
members. 

In this particular case, we use the DrawingBoard class (written by the author). This 
is a helper class that takes care of programming aspects we have not yet mastered, such as 
moving multiple geometric shapes in a smooth motion across the screen. It is not an issue 
of whether we can develop this class by ourselves, because no matter how good we be¬ 
come as programmers, we would rarely develop an application completely on our own. 

We already used many predefined classes from the Java standard libraries, but 
the way we will use the predefined class here is different. When we developed programs 
before, the classes we wrote called the methods of predefined classes. Our main method 
creating a GregorianCalendar object and calling its methods is one example. Here, for 
us to use a predefined class, we must define another class that provides necessary ser¬ 
vices to this predefined class. Figure 5.14 differentiates the two types of predefined 
classes.The first type does not place any restriction other than calling the methods cor¬ 
rectly, while the second type requires us to implement helper classes in a specific manner 
to support it. 

In our case, the predefined class DrawingBoard will require another class named 
DrawableShape that will assume the responsibility of drawing individual geometric 
shapes. So, to use the DrawingBoard class in our program, we must implement the class 
named DrawableShape. And we must implement the DrawableShape class in a specific 
way. The use of the DrawingBoard class dictates that we define a set of fixed methods in 
the DrawableShape class. We can add more, but we must at the minimum provide the 
specified set of fixed methods because the DrawingBoard class will need to call these 
methods. The methods are "fixed" in the method signature—method name, the number of 
parameters and their types, and return type—but the method body can be defined in any 
way we like. This is how the flexibility is achieved. For example, the DrawableShape class 
we define must include a method named draw with the dictated signature. But it's up to us 
to decide what we put in the method body. So we can choose, for example, to implement 
the method to draw a circle, rectangle, or any other geometric shape of our choosing. 

As always, we will develop this program following incremental development steps. 
The incremental development steps we will take here are slightly different in character 
from those we have seen so far. In the previous incremental developments, we knew all 
the ingredients,so to speak. Here we have to include a step to explore the DrawingBoard 
class. We will find out shortly that to use the DrawingBoard class, we will have to deal with 
some Java standard classes we have not seen yet. Pedagogically, a textbook may try to 
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MyClassl 


Type 1 Class 

\() 


G 


There's no restriction in 
using type 1 predefined 
classes other than calling 
their methods correctly. 



0 A class we implement 
Q A class given to us 


To use type 2 predefined 
classes, we must define 
helper classes required by 
the predefined classes. 


Figure 5.14 Two types of predefined classes.The first type does not require us to do anything more 
than use the predefined classes by calling their methods.The second type requires us to define helper 
classes for the predefined classes we want to use. 


explain beforehand everything that is necessary to understand the sample programs. 
But no textbook can explain everything. When we develop programs, there will always be 
a time when we encounter some unknown classes. We need to learn how to deal with 
such a situation in our development steps. 

Problem Statement 

Write an application that simulates a screensaver by drawing various geometric 
shapes in different colors. The user has the option of choosing a type (ellipse or 
rectangle), color, and movement (stationary, smooth, or random). 

Overall Plan 

We will begin with our overall plan for the development. Let's begin with the outline of 
program logic. We first let the user select the shape, its movement, and its color, and we 
then start drawing. We express the program flow as having four tasks: 

1. Get the shape the user wants to draw. 

2. Get the color of the chosen shape. 

3. Get the type of movement the user wants to use. 

4. Start the drawing. 
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Let's look at each task and determine an object that will be responsible for handling 
the task. For the first three tasks, we can use our old friend Scanner. We will get into the 
details of exactly how we ask the users to input those values in the later incremental 
steps. For the last task of actually drawing the selected shape, we need to define our own 
class.The task is too specific to the program, and there is no suitable object in the stan¬ 
dard packages that does the job. As discussed earlier, we will use a given predefined class 
DrawingBoard and define the required helper class DrawableShape. 

We will define a top-level control object that manages all these objects. We will call 
this class Ch5DrawShape. As explained in Section 4.10, we will make this control object 
the main class. Flere's our working design document: 


Design Document: Ch 5Dr awShape 

Class 

Purpose 

Ch5DrawShape 

The top-level control object that manages other objects 
in the program. This is the main class, as explained in 

Section 4.10. 

D r a wi ngBoard 

The given predefined class that handles the movement of 
Drawabl eShape objects. 

Drawabl eShape 

The class for handling the drawing of individual shapes. 

Scanner 

The standard class for handling input routines. 


Figure 5.15 is the program diagram for this program. 



Figure 5.15 The program diagram for the Ch5DrawShape program. 
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development 

steps 


step 1 
design 


We will implement this program in the following six major steps: 

1. Start with a program skeleton. Explore the DrawingBoard class. 

2. Define an experimental DrawableShape class that draws a dummy shape. 

3. Add code to allow the user to select a shape. Extend the DrawableShape and 
other classes as necessary. 

4. Add code to allow the user to specify the color. Extend the DrawableShape and 
other classes as necessary. 

5. Add code to allow the user to specify the motion type. Extend the DrawableShape 
and other classes as necessary. 

6. Finalize the code by tying up loose ends. 

Our first task is to find out about the given class. We could have designed the input rou¬ 
tines first, but without knowing much about the given class, it would be difficult to design 
suitable input routines. When we use an unknown class, it is most appropriate to find out 
more about this given class before we plan any input or output routines. Just as the de¬ 
velopment steps are incremental, our exploration of the given class will be incremental. 
Instead of trying to find out everything about the class at once, we begin with the basic 
features and skeleton code. As we learn more about the given class incrementally, we 
extend our code correspondingly. 


Step 1 Development: Program Skeleton 

We begin the development with the skeleton main class.The main purpose in step 1 is to 
use the DrawingBoard class in the simplest manner to establish the launch pad for the 
development. To do so, we must first learn a bit about the given DrawingBoard class. 
Here's a brief description of the DrawingBoard class. In a real-world situation, we would 
be finding out about the given class by reading its accompanying documentation or 
some other external sources. The documentation may come in form of online javadoc 
documents or reference manuals. 


DrawingBoard 

An instance of this class will support the drawing ofDrawabl eShape objects. Shapes 
can be drawn at fixed stationary positions, at random positions, or in a smooth motion 
at the specified speed. The actual drawing of the individual shapes is done inside the 
Dr a w a b I eShape class. The client programmer decides which shape to draw. 

public void addShape ( DrawableShape shape ) 

Adds shape to this Drawi ngBoard object. You can add an unlimited number 
ofDrawabl eShape objects. 

(Continued) 
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DrawingBoard (Continued) 

public void set Background( java,awt.Color color ) 

Sets the background color of this Dr a wi ngBoard object to the designated 
color.The default background color is black. 

public void set Del ayTi me( double delay ) 

Sets the delay time between drawings to d e I ay seconds. The smaller the delay 
time, the faster the shapes move. If the movement type is other than SMOOTH, 
then setting the delay time has no visual effect. 

public void set Movement) Movement type ) 

Sets the movement type to t y p e . Class constants for three types of motion are 
Move me nt. STATI ONARY —draw shapes at fixed positions, 

Mo v e me n t. RANDOM—draw shapes at random positions,and 
Move me nt. SMOOTH —draw shapes in a smooth motion. 

public void s e t Visi bI e ( boolean state ) 

Makes this Dr a wi ngBoard object appear on or disappear from the screen 
if S t a t e is t r u e or f a I s e, respectively. To simulate the screensaver, 
setting it visible will cause a maximized window to appear on the screen. 

public void start) ) 

Starts the drawing. If the window is not visible yet, it will be made visible before 
the drawing begins. 


Among the defined methods, we see the setVisible method is the one to make 
it appear on the screen. All other methods pertain to adding DrawableShape objects 
and setting the properties of a DrawingBoard object. We will explain the standard 
java.awt.Color class when we use the setBackground method in the later step. In this 
step, we will keep the code very simple by only making it appear on the screen. We will 
deal with other methods in the later steps. 

Our working design document for the Ch5DrawShape class is as follows: 


Design Document: The Ch 5Dr awShape Class 

Method 

Visibility 

Purpose 

<constructor> 

public 

Creates a D r a w i ngBoard object. 

ma i n 

publ i c 

This is main method of the class. 

start 

publ i c 

Starts the program by opening a 

Drawi ngBoard object. 
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step 1 code Since this is a skeleton code, it is very basic. Here's the code: 

w 

I * 

Chapter 5 Sample Development: Drawing Shapes (Step 1) 
The main class of the program. 

*/ 

class Ch5Dr awShape { 

private Drawi ngBoard canvas; 

public Ch5DrawShape( ) { 

canvas = new Drawl n g B o a r d ( ); 

} 

public void start! ) { 

canvas. setVi si bl e(true); 

} 

public static void mai n(Stri ng[] args) { 

Ch5Dr awShape screensaver = new Ch5 Dr awShape ( ); 
screensaver. start!); 

} 


step 1 test The purpose of step 1 testing is to verify that a DrawingBoard object appears 

correctly on the screen. Since this is our first encounter with the DrawingBoard class, 
it is probable that we are not understanding its documentation fully and completely. 
We need to verify this in this step. When a maximized window with the black back¬ 
ground appears on the screen, we know the main class was executed properly. 
After we verify the correct execution of the step 1 program, we will proceed to imple¬ 
ment additional methods of Ch5DrawShape and gradually build up the required 
DrawableShape class. 

Step 2 Development: Draw a Shape 

step 2 In the second development step, we will implement a preliminary DrawableShape 

design c | ass anc | some shapes appear on a DrawingBoard window. To draw shapes, 

we need to add them to a DrawingBoard window. And to do so, we need to define the 
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DrawableShape class with the specified set of methods. Here are the required methods 
and a brief description of what to accomplish in them: 


Required Methods of Dr a wa b I e Shape 

public void draw(j ava. awt. Graphi cs) 

Draw a geometric shape on thej ava. awt. Graphi cs. The Dr a wi ngBoard 
window calls the draw method ofDrawabl eShape objects added to it. 
public j ava. awt. Poi nt get CenterPoi nt ( ) 

Return the center point of this shape, 
public java,awt.Dimension getDi mensi on( ) 

Return the bounding rectangle of this shape as a Di mensi on. 
public void set CenterPoi nt ( j ava, awt. Poi nt ) 

Set the center point of this shape.The Dr a wi ngBoard window calls the 
set Cent er Poi nt method ofDrawabl eShape objects to update their 
positions in the S MOOT H movement type. 


At this stage, the main task is for us to confirm our understanding of the require¬ 
ments in implementing the DrawableShape class. Once we get this confirmation, we can 
get into the details of the full-blown DrawableShape class. 

To keep the preliminary class simple, we draw three filled circles of a fixed size and 
color. The DrawableShape class includes a single data member centerPoint to keep 
track of the shape's center point. If we fix the radius of the circles to 100 pixels, that is, the 
bounding rectangle is 200 pixels by 200 pixels, and the color to blue, then the draw 
method can be written as follows: 



200 


publ i c void draw(Graphi cs g) { 
g. set Col or ( Col or. bl ue) ; 

g. fil I Oval ( cent er Pol nt. x- 100, cent er Pol nt. y- 1 0 0, 2 0 0, 2 0 0 ); 


Since the size is fixed, we simply return a new Dimension object for the 

getDimension method: 


public Dimension getDi mensi on( ) { 
return new Di mensi on(200, 200); 

} 


For the setCenterPoint and getCenterPoint methods, we assign the passed para¬ 
meter to the data member centerPoint and return the current value of the data member 
centerPoint, respectively. 
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We are now ready to modify the Ch5DrawShape class to draw three filled circles. 
We will implement this by modifying the start method. First we need to create three 

DrawableShape objects and add them to the DrawingBoard object canvas: 

Drawabl eShape shapel = new DrawableShape)); 

DrawableShape s ha pe 2 = new DrawableShape)); 

DrawableShape s ha pe3 = new DrawableShape)); 

shapel.setCenterPoi nt(new Poi nt ( 2 5 0, 300)); 
shape2. set Cent er Poi nt(new Poi n t ( 5 0 0, 300)); 
shape3. set Cent er Poi nt(new Poi n t ( 7 5 0, 300)); 

canvas.addShape(shapel); 
canvas.addShape)shape2) ; 
canvas.addShape)shape3) ; 

Then we set the motion type to SMOOTH movement, make the window appear on the 
screen, and start the drawing: 

canvas, set Movement ( Drawi ngBoard. Movement. SMOOTFI) ; 
canvas.set Vi si bl e(true); 
canvas. start)); 

step 2 code Here's the code for the preliminary DrawableShape class: 


i mpor t j a va. a wt. *; 

I* 

Step 2: Add a preliminary DrawableShape class 


A class whose instances know how 

*1 

class Drawabl eShape { 

private Point centerPoint; 
public Dr awabl eShape) ) { 
centerPoint = null; 

} 

public void d r a w( Gr a p h i c s g) { 

g. s et Co I o r ( Co I o r. bl ue ) ; 
g.fiI I Oval (centerPoi nt.x - 10 

} 


to draw the ms elves. 



centerPoi nt.y-100, 200, 200); 
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public Point get Cent er Poi nt ( ) { 
return cent er Poi nt; 

} 

public Dimension getDi mensi on( ) { 
return new Dimension(200, 200); 

} 

public void setCenterPoi nt ( Poi nt point) { 
centerPoint = point; 

} 

} 


c 

c 


getCenterPoint 


getDimension 




setCenterPoint 


oint 


The Ch5DrawShape class now has the modified start method as designed (the rest of 
the class remains the same): 


i mpo r t j a v a. a wt. *; 

/ * 

Chapter 5 S a mp I e Development: Start drawing shapes (Step 2) 
The main class of the program. 

*/ 

class Ch 5Dra wS ha pe { 


public void start) ) { 

Dr awabI eShape shapel = new Dr awabI eShape () 
Dr awabI eShape s ha pe2 = new Dr awabI eShape () 
Dr awabI eShape s ha pe3 = new Dr awabI eShape () 

shapel.setCenterPoi nt ( new Poi nt ( 2 5 0, 300)); 
shape2. setCenterPoi n t ( new Poi n t ( 5 0 0, 300)); 
shape3. set Cent er Poi nt(new Poi n t ( 7 5 0, 300)); 

canvas.addShape(shapel); 
canvas.addShape(shape2); 
canvas.addShape(shape3); 


start 
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canvas, set Move ment (Dr a wi ngBoard, Move ment. SMOOTH); 

canvas. setVi si bl e(tr ue); 
c a nvas. s t a r t (); 


} 



step 2 test 


Now we run the program and verify the three bouncing circles moving around. 
To test other options of the DrawingBoard class, we will try the other methods with 
different parameters: 


Method 

Test Parameter 

set Movement 

Try both Drawl ngBoard, STATI ONARY and 

D r a wi ngBoard, RANDOM. 

s e t De 1 a y T i me 

Try values ranging from 0.1 to 3.0. 

set Background 

Try several different Co 1 or constants such 
asCol or. white, Co 1 o r. r e d,and 

Col or. green. 


We insert these testing statements before the statement 
canvas. setVi si bl e ( true); 

in the start method. 

Another testing option we should try is the drawing of different geometric shapes. 
We can replace the drawing statement inside the draw method from 

g.fiI I Oval (centerPoi nt.x-100, centerPoi nt. y- 100, 

2 0 0 , 2 0 0 ); 


to 


g.fiI I Rect (cent er Poi nt. x - 100, centerPoi nt. y - 100, 

2 0 0 , 2 0 0 ); 


or 


g.fiI I RoundRect (centerPoi nt.x-100, centerPoint.y-100, 
200, 200, 50, 50); 

to draw a filled rectangle or a filled rounded rectangle, respectively. 
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step 3 
design 


design 
alternative 1 


design 
alternative 2 


Step 3 Development: Allow the User to Select a Shape 

Now that we know how to interact with the DrawingBoard class, we can proceed to 
develop the user interface portion of the program.There are three categories in which 
the user can select an option: shape, color, and motion. We will work on the shape selec¬ 
tion here and on the color and motion selection in the next two steps. Once we are done 
with this step, the next two steps are fairly straightforward because the idea is essentially 
the same. 

Let's allow the user to select one of three shapes—ellipse, rectangle, and rounded 
rectangle—the shapes we know how to draw at this point. We can add more fancy shapes 
later. In what ways should we allow the user to input the shape? There are two possible 
alternatives:The first would ask the user to enter the text and spell out the shape, and the 
second would ask the user to enter a number that corresponds to the shape (1 for ellipse, 
2 for rectangle, 3 for rounded rectangle, e.g.). Which is the better alternative? 

We anticipate at least two problems with the first input style. When we need to get 
a user's name,for example, there's no good alternative other than asking the user to enter 
his or her name. But when we want the user to select one of the few available choices, it 
is cumbersome and too much of a burden for the user. Moreover, it is prone to mistyping. 

To allow the user to make a selection quickly and easily, we can let the user select 
one of the available choices by entering a corresponding number. We will list the choices 
with numbers 1,2, and 3 and get the user's selection as follows: 


System, out. print) “Selection: Enter the Shape number\n" + 
" 1 - Ellipse \ n" + 

2 - Rectangle \ n“ + 

" 3 - Rounded Rectangle \n" ) ; 

i n t selection = s c a n n e r. n ex 11 n t () ; 


For getting the dimension of the shape, we accept the width and height values 
from the user. The values cannot be negative, for sure, but we also want to restrict the 
values to a certain range. We do not want the shape to be too small or too large. Let's set 
the minimum to 100 pixels and the maximum to 500 pixels. If the user enters a value 
outside the acceptable range, we will set the value to 100. The input routine for the width 
can be written as follows: 


System, out. print) "Enter the width of the s h a p e \ n" + 
“between 100 and 500 inclusive: 11 ) 

int width = scanner. nextlnt)); 

if (width < 100 || width > 500) { 
wi dt h = 100; 

} 

The input routine for the height will work in the same manner. 
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For getting the x and y values of the shape's center point, we follow the pattern of 
getting the width and height values. We will set the acceptable range for the x value to 
200 and 800, inclusive, and the y value to 100 and 600, inclusive. 

Our next task is to modify the DrawableShape class so it will be able to draw three 
different geometric shapes. First we change the constructor to accept the three input 
values: 

public Drawabl eShape(Type sType, Dimension sDim, 

Point sCent er ) { 

type = sType; 

di mens i on = s Di m; 
cent er Poi nt = sCent er; 

} 

The variables type, dimension, and centerPoint are data members for keeping track of 
necessary information. 

Next, we define the data member constants as follows: 

public static enumType {ELLIPSE, RECTANGLE, ROUNDED_RECTANGLE } 

private static final Dimension DEFAULT_DI MENSI ON 

= new Dimension(200, 200); 

private static final Point DE FAULT_ CE NT E R_PT 

= new Poi nt ( 350, 350) ; 

In the previous step, the draw method drew a fixed-size circle. We need to modify 
it to draw three different geometric shapes based on the value of the data member type. 
We can modify the method to 

public void drawl Graphics g) { 
g, set Col or ( Col or. bl ue) ; 
drawShapelg); 

} 

with the private method drawShape defined as 

private void drawShape ( Graphi cs g) { 
s wi t c h (type) { 
case ELLIPSE: 

II code to draw a filled oval comes here 

break; 

case RECTANGLE: 

II code to draw a filled rectangle comes here 

break; 
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case R0UNDED_ RECTANGLE: 

II code to draw a filled rounded rectangle 
II c o me s here 

break; 

} 

} 

step 3 code Here's the modified main class Ch5DrawShape: 

i mpo r t j a v a. a wt. *; 
import java.util.*; 

/ * 

Chapter 5 Sample Development: Handle User Input for Shape Type (Step 3) 
The main class of the program. 

*/ 

class Ch 5Dra wS ha pe { 


public void start) ) { 

Drawabl eShape shapel = getShape!); 

canvas. addShape(shapel); 

canvas, set Movement ( Drawi ngBoard. S MOOTH) ; 

canvas.set Vi si bl e(true); 
canvas. start(); 


/ -\ 

start 


private DrawableShape get Shape! ) { getshape 

Drawabl eShape.Type type = i nputShapeType () ; 

Dimension dim = i nputDi mensi on(); 

Point centerPt = i nputCenterPoi nt ( ) ; 

DrawableShape shape = new Dr awabl eShape! t ype, dim, centerPt); 
return shape; 
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private Drawabl eShape.Type i nputShapeType( ) { 


( - 

inputShapeType 


System, out. print) "Selection: Enter the Shape numberin' 1 + 
' 1 - Ellipse \ n" + 

■ 2 - Rectangle \n" + 

■ 3 - Rounded Rectangle \n"); 


■\ 

W 


i nt selection = scanner. next I nt ( ) ; 


Drawabl eShape.Type type; 
switch (selection) { 

case 1: type = Drawabl eShape.Type. ELLI PSE; 
break; 

case 2: type = Drawabl eShape.Type. RECTANGLE; 

break; 

case 3: type = Drawabl eShape. Type. ROUNDED_RECTANGLE; 

break; 

default: type = Drawabl eShape.Type. ELLI PSE; 
break; 


} 


return type; 

} 


private Dimension i nputDi mensi on( ) { inputDimension 


System, out. print) "Enter the width of the shape! n" + 
“between 100 and 500 inclusive: ") 


int width = scanner. nextlnt)); 

if (width < 100 || width > 500) { 
wi d t h = 10 0; 

} 

System, out. print) "Enter the height of the shape! n" + 
"between 100 and 500 inclusive: "); 

int height = scanner. nextlnt)); 

if (height <100 | | height > 5 0 0 ) { 
height =100; 

} 

return new Di mensi on(wi dth, height); 
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private Point i nputCenterPoi nt( ) 

System, out. print! "Enter the x 
"between 200 


{ inputCenterPoint 

BP 

value of the center p oi n t\n" + 
and 800 inclusive: "); 


i n t x = scanner, n ex11 nt () ; 

i f ( x < 2 0 0 | | x > 8 0 0 ) { 
x = 200; 

} 

System, out. print! "Enter the y value of the center p o i n t \ n" + 
“between 100 and 500 inclusive: "); 


int y = scanner. nextlnt(); 

if ( y < 100 || y > 500) { 
y = 100; 

} 

return new Poi nt ( x, y) ; 


} 


The DrawableShape class is now modified to this: 


i mp o r t j a v a. a wt. *; 


Step 3: Draw different shapes 

A class whose instances know how to draw themselves. 


'/ 


class DrawableShape { 


Data Members 


public static enum Type {ELLI PSE, RECTANGLE, ROUNDED_RECTANGLE} 


private static final Dimension DEFAULT_DI MENSI ON 

= new Dimension(200, 200); 
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private static final Point DEFAULT_CENTER_PT 
private Point cent er Poi nt; 
private Dimension dimension; 
privat e Type type; 


new Poi nt ( 350, 350); 


Constructor 


public Drawabl eShape(Type sType, Dimension sDim, Point sCenter) { 


type 

di mens i on 
cent er Poi nt 


sType; 
s Di m; 
sCenter; 


} 


public void d r a w ( Graphics g) { 
g. set Col or ( Col or. bl ue) ; 
drawS hape(g); 

} 


draw 


public void setTypefType shapeType) { 
type = shapeType; 

} 


private void drawShape ( Graphi cs g) { 
swit c h (type) { 
case ELLIPSE: 

g.fiI I Oval (centerPoi nt.x - di 
centerPoint.y - di 
d i me n s i o n. wi d t h, 
di mensi on. hei ght); 

break; 


setType 


drawShape 


mensi on. wi dth/2, 
mensi on. height/2, 


case RECTANGLE: 

g.fiI I Rect ( centerPoi nt.x - di mensi on. wi dth/2, 
centerPoint.y - di me nsion.height/2, 
d i me n s i o n. wi d t h, 
di mensi on. hei ght); 

break; 


case ROUNDED_RECTANGLE: 

g. fi I I RoundRect(centerPoi nt. x - dime nsion. width/2, 
centerPoint.y - di me nsion.height/2, 
di mens i on. wi dt h, 
di mensi on. hei ght, 
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} 


} 


} 


break; 


( i nt) (di mensi on. wi dth * 0. 
(int) (di mension. height * 0 


), 

3)); 


Notice how we add code for handling the case when an invalid number is entered in 
the inputShapeType method. We use the default case to set the shape type to ELLIPSE 
if an invalid value is entered. In addition to handling the invalid entries, it is critical for us 
to make sure that all valid entries are handled correctly. For example, we cannot leave the 
type undefined or assigned to a wrong value when one of the valid data is entered. 


■ Things to Remember 



When we write a selection control statement, we must make sure that all possible 
cases are handled correctly. 


step 3 test Now we run t ' ie P ro g ram multiple times, trying various shape types, dimensions, 

and center points. After we verify that everything is working as expected, we proceed to 
the next step. 

Step 4 Development: Allow the User to Select a Color 

step4 In the fourth development step, we add a routine that allows the user to specify the color 

design of the selected shape. We adopt the same input style for accepting the shape type as in 

step 3. We list five different color choices and let the user select one of them by entering 
the corresponding number. We use a default color when an invalid number is entered. 
Analogous to the shape selection routine, we will add a method named inputColortothe 
Ch5DrawShape class. The structure of this method is identical to that of the input meth¬ 
ods, except the return type is Color. Using the inputColor method, we can define the 
getShape method as follows: 

pri vate Dr awabl eShape get Shape ( ) { 

Drawabl eShape.Type type = i nputShapeType (); 

Di me nsion dim = inputDi mensi on(); 
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Point centerPt = i nputCenterPoi nt () ; 

Col or color = I nput Col or (); 

Drawabl eShape shape 

= new Drawabl eShape(type, dim, centerPt, color); 
return shape; 

} 

We make a small extension to the DrawableShape class by changing the con¬ 
structor to accept a color as its fourth argument and adding a data member to keep track 
of the selected color. 

step 4 code Here's the modified Ch5DrawShape class: 

i mpor t j a va. a wt . *; 
import java,util.*; 

/ * 

Chapter 5 Sample Develop me nt: Color selection (Step 4) 

The main class of the program. 

*/ 

class Ch5Dr awShape { 


private DrawableShape getShape( ) { getshape 

Drawabl eShape,Type type = i nputShapeType ( ); 

Dimension dim = i nputDi mensi on(); 

Point centerPt = i nputCenterPol nt () ; 

Col or color = i nput Col or (); 

DrawableShape shape 

= new Drawabl eShape(type, dim, centerPt, color); 
return shape; 

} 

private Color inputColorf ) { inputcolor 

System, out. print! "Selection: Enter the Color numberin' 1 + 

" 1 - Red \n" + 

' 2 - Green \n" + 

" 3 - Blue \ n" + 

■ 4 - YelI ow \n" + 

" 5 - Magent a \ n" ) ; 

i nt selection = s c a n n e r. n ex 11 nt () ; 
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Color color; 
s wi t c h (selection) { 


case 

1: 

color =Color.red; 

break; 

case 

2: 

color = Col or. gr een; 

break; 

case 

3: 

color = Col or. bl ue; 

break; 

case 

4: 

color = Co lor.yellow; 

break; 

case 

5: 

color = Color, magenta 

break; 

default: 

color = C o 1 o r. r e d; 

break; 


return color; 

} 


The DrawableShape class is now modified to this: 

W 

i mpor t j a va. a wt. *; 

/* 

Step 4: Adds the color choice 

A class whose instances know how to draw themselves. 

*1 

class DrawableShape { 


private static final Color DEFAULT_COLOR = Color.BLUE; 

Data Members 


www.it-ebooks.info 








5.8 Sample Development 291 


private Color fill Co lor; 


public Drawabl eShape(Type sType, Dimension sDim, 

Point sCenter, Color sCo lor) 

type = sType; 

d i me n s i o n = s Di m; 
centerPoi nt = sCenter; 
f i I I Col or = s Co lor; 


public void draw(Graphi cs g) { 
g. set Col or ( fI I I Col or ) ; 

drawShapef g); 


/ > 

Constructor 


/-\ 

draw 


} 


} 


step 4 test 


Now we run the program several times, each time selecting a different color, and 
we verify that the shape is drawn in the chosen color. After we verify the program, we 
move on to the next step. 


Step 5 Development: Allow the User to Select a Motion Type 

step 5 In the fifth development step, we add a routine that allows the user to select the motion 

design type. We give three choices to the user: stationary, random, or smooth. The same design 

we used in steps 3 and 4 is applicable here, so we adopt it for the motion type selection 
also. Since we adopt the same design, we can ease into the coding phase, 
step 5 code Here's the modified main class Ch5DrawShape: 


i mpo r t j a v a. a wt. *; 
import java,util.*; 

/ * 

Chapter 5 Sample Development: Color selection (Step 5) 
The main class of the program. 

*/ 

class Ch 5Dr a wS ha pe { 
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5.8 Sample Development— continued 


public void start) ) { 

Drawabl eShape shapel = getShape) ) ; 

canvas, addShape(shapel); 

canvas, set Movement ( i nput Moti onType ()) ; 

canvas. setVi si bl e(true); 
canvas, start)); 


private Drawi ngBoard. Movement input Mo tionType) ) { 


inputMotionType 


System, out. print) "Selection: Enter the Motion numberin' 1 + 

1 - Stationary (no move ment) \n" + 

" 2 - Ra ndom Movemen t \ n" + 

' 3 - Smoot h Movement \ n" ); 

i nt selection = s c a n n e r. n ex 1 1 nt () ; 

Drawi ngBoard, Movement type; 
s wi t c h (selection) { 


case 1: 

case 2: 

case 3: 

default 


type = 

break; 

type = 

break; 

type = 

break; 

type = 

break; 


Drawi ngBoard. Movement. STATI ONARY; 
Drawi ngBoard, Movement, RANDOM; 
Drawi ngBoard, Movement. SMOOTH; 
Drawi ngBoard, Movement. SMOOTH; 


} 


return type; 


No changes are required for the DrawableShape class, as the DrawingBoard class 
is the one responsible for the shape movement. 
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Now we run the program multiple times and test all three motion types. From what 
we have done, we can't imagine the code we have already written in the earlier steps to 
cause any problems; but if we are not careful, a slight change in one step could cause the 
code developed from the earlier steps to stop working correctly (e.g., erroneously reusing 
data members in newly written methods). So we should continue to test all aspects of the 
program diligently. After we are satisfied with the program, we proceed to the final step. 


program 

review 


possible 

extensions 


Step 6 Development: Finalize 

We will perform a critical review of the program, looking for any unfinished method, 
inconsistency or error in the methods, unclear or missing comments, and so forth. We 
should also not forget to improve the program for cleaner code and better readability. 
Another activity we can pursue in the final step is to look for extensions. 

There are several interesting extensions we can make to the program. First is the 
morphing of an object. In the current implementation, once the shape is selected, it will 
not change. It would be more fun to see the shape changes; for example, the width and 
height of the shape's dimension can be set to vary while the shape is drawn. Another 
interesting variation is to make a circle morph into a rectangle and morph back into a 
circle. Second is the drawing of multiple shapes.Third is the variation in color while the 
shape is drawn. Fourth is the drawing of a text (we"draw"a text on the Graphics context 
just as we draw geometric shapes). You can make the text scroll across the screen from 
right to left by setting the motion type of DrawingBoard to STATIONARY and updating 
the center point value within our DrawableShape class. All these extensions are left as 
exercises. 


Summary 


• A selection control statement is used to alter the sequential flow of control. 

• The if and switch statements are two types of selection control. 

• The two versions of the if statement are if-then-else and if-then. 

• A boolean expression contains conditional and boolean operators and 
evaluates to true or false. 

• Three boolean operators in Java are AND (&&), OR (II), and NOT (!). 

• DeMorgan’s laws state !(P &&Q) and IP II !Q are equivalent and !(P II Q) and 
IP && IQ are equivalent. 

• Logical operators && and II are evaluated by using the short-circuit 
evaluation technique. 

• A boolean flag is useful in keeping track of program settings. 

• An if statement can be a part of the then or else block of another if statement 
to formulate nested if statements. 

• Careful attention to details is important to avoid illogically constructed 
nested if statements. 
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When the equality symbol == is used in comparing the variables of reference 
data type, we are comparing the addresses. 

The switch statement is useful for expressing a selection control based on 
equality testing between data of type char, byte, short, or int. 

The break statement causes the control to break out of the surrounding switch 
statement (note: also from other control statements introduced in Chap. 6). 
The standard classes introduced in this chapter are 

java.awt.Graphics java.awt.Point 

java.awt.Color java.awt. Dimension 

The java.awt.Graphics class is used to draw geometric shapes. 

The java. awt. Color class is used to set the color of various GUI components. 
The java. awt. Point class is used to represent a point in two-dimensional space. 
The java. awt. Dimension class is used to represent a bounding rectangle of 
geometric shapes and other GUI components. 

The enumerated constants provide type safety and increase the program 
readability. 


Key Concepts 


sequential execution 
control statements 
if statement 
boolean expressions 
relational operators 
selection statements 
nested if statements 


increment and decrement operators 
boolean operators 
switch statements 
break statements 
defensive programming 
content pane of a frame 
enumerated constants 


Review Exercises 


1. Indent 

the following if statements properly. 

a. 

i f 

(a == b) 

if (c == d) a = 1; else b = 1; else 

b. 

i f 

(a == b) 

a = 1; if ( c = = d ) b = 1; el se c = 1 

c. 

i f 

(a == b) 

{if ( c == d ) a = 1; b = 2; } else b 

d. 

i f 

(a == b) 

{ 


i f 

(c == d) 

a = 1; b = 2; } 


el s 

e { b = 1; 

i f ( a == d) d = 3; } 

2. Which 

two of the following three if statements are equivalent? 

a. 

i f 

(a == b) 



if ( c == d) a = 1; 
else b = 1; 
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b. if (a == b) { 

if ( c == d) a = 1 ; } 
else b = 1; 

c. i f (a == b ) 

if ( c == d ) a = 1; 
else b = 1; 

3. Evaluate the following boolean expressions. For each of the following 
expressions, assume x is 10, y is 20, and z is 30. Indicate which of the 
following boolean expressions are always true and which are always false, 
regardless of the values for x, y, or z. 


a. x <10 || x >10 

b. x > y && y > x 

c. ( x <y + z) &&(x +10 < = 2 0) 

d. z - y == x && Math.a b s ( y - z) == x 

e. x < 10 && x > 10 

f. x > y | | y > x 

g. ! ( x < y + z ) || !(x + 10 <= 20) 

h. ! ( x == y )) && (x != y) && (x < y || y < x) 

4. Express the following switch statement by using nested if statements, 
switch (grade) { 


case 

10 : 


case 

9 : 

a = 1 
b = 2 

break 

case 

8 : 

a = 3 
b = 4 

break 

default: 

a = 5 
break 


5. Write an if statement to find the smallest of three given integers without 
using the min method of the Math class. 

6. Draw control flow diagrams for the following two switch statements. 


switch (choice) { 


case 

1: 

a = 0 

break 

case 

2 : 

b = 1 
break 

case 

3 : 

c = 2 

break 

default: 

d = 3 
break 


s wi t c h (choice) { 
case 1 : a = 0 ; 

case 2 : b = 1 ; 

case 3: c = 2; 

default: d = 3 ; 

} 
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7. Write an if statement that prints out a message based on the following rules: 


If the Total Points Are 

Message to Print 

> 100 

You won a free cup of coffee. 

>200 

You won a free cup of coffee and a regular-size doughnut. 

>300 

You won a free cup of coffee and a regular-size 
doughnut and a 12-oz orange juice. 

>400 

You won a free cup of coffee and a regular-size dough¬ 
nut and a 1 2-oz orange juice and a combo breakfast. 

>500 

You won a free cup of coffee and a regular-size 
doughnut and a 12-oz orange juice and a combo 
breakfast and a reserved table for one week. 


8. Rewrite the following if statement, using a switch statement. 


selection 

= scanner 

. next 1 nt 

( ) 

I 


i f 

( sel ect 

i on == 0) 







System. 

out. pri nt 

1 n ( 

“You 

s e 1 

ect ed 

Magent a 

el 

se if ( s 

el ecti on 

= = 

1) 





System. 

out. pri nt 

1 n ( 

“You 

s e 1 

ect ed 

Cyan"); 

el 

se if ( s 

el ecti on 

= = 

2) 





System. 

out. pri nt 

1 n ( 

"You 

s e 1 

ect ed 

Red"); 

e 1 

se if ( s 

election 

= = 

3) 





System. 

out. pri nt 

1 n ( 

"You 

s e 1 

ect ed 

B1 u e" ); 

el 

se if ( s 

election 

= = 

4) 





System. 

out. pri nt 

1 n ( 

"You 

s e 1 

ect ed 

Green") 

el 

se 








System. 

out. pri nt 

1 n ( 

"1 n v a 

1 i d 

sel ec 

ti on"); 


Level 1 Programming Exercises ★ 

9. One million is 10 6 and 1 billion is 10 9 . Write a program that reads a power 
of 10 (6, 9, 12, etc.) and displays how big the number is (Million, Billion, 
etc.). Display an appropriate message for the input value that has no 
corresponding word. The table below shows the correspondence between 
the power of 10 and the word for that number. 


er of 10 

Number 

6 

Million 

9 

Billion 

12 

Trillion 

15 

Quadrillion 

18 

Quintillion 

21 

Sextillion 

30 

Nonillion 

100 

Googol 
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10. Write a program RecommendedWeightWithTest by extending the 
RecommendedWeight (see Exercise 8 on page 209). The extended program 
will include the following test: 

if (the height is between 140cm and 230cm) 
compute the recommended weight 

else 

display an error message 

11. Extend the RecommendedWeightWithTest program in Exercise 12 by 
allowing the user to enter his or her weight and printing out the message You 
should exercise more if the weight is more than 10 lb over the ideal weight 
and You need more nourishment if the weight is more than 20 lb under the 
recommended weight. 

Level 2 Programming Exercises ★★ 

12. Write a program that replies either Leap Year or Not a Leap Year, given a 
year. It is a leap year if the year is divisible by 4 but not by 100 (for 
example, 1796 is a leap year because it is divisible by 4 but not by 100). A 
year that is divisible by both 4 and 100 is a leap year if it is also divisible by 
400 (for example, 2000 is a leap year, but 1800 is not). 

13. Employees at MyJava Lo-Fat Burgers earn the basic hourly wage of $7.25. 
They will receive time-and-a-half of their basic rate for overtime hours. 

In addition, they will receive a commission on the sales they generate 
while tending the counter. The commission is based on the following 
formula: 


Sales Volume 

Commission 

$1.00 to $99.99 

5% of total sales 

$100.00 to $299.99 

10% of total sales 

> $300.00 

15% of total sales 


Write a program that inputs the number of hours worked and the total sales 
and computes the wage. 

14. Using the DrawingBoard class, write a screensaver that displays a scrolling 
text message. The text messages moves across the window, starting from the 
right edge toward the left edge. Set the motion type to stationary, so the 
DrawingBoard does not adjust the position. You have to adjust the text’s 
position inside your DrawableShape. 

15. Define a class called Triangle that is capable of computing the perimeter and 
area of a triangle, given its three sides a, b. and c, as shown below. Notice 
that side b is the base of the triangle. 


www.it-ebooks.info 





298 


Chapter 5 Selection Statements 


Perimeter = a + b + c 

Area = Vs(s — a)(s — b)(s - c) 

, a + b + c 

where s =- 

b 2 

The design of this class is identical to that for the Ch5Circle class from 
Section 5.1. Define a private method isValid to check the validity of three 
sides. If any one of them is invalid, the methods getArea and getPerimeter 
will return the constant INVALID_DIMENSION. 

16. Modify the Ch5RoomWinner class so the three dorm lottery cards are drawn 
vertically. Make the code for drawing flexible by using the HEIGHT constant 
in determining the placement of three cards. 

Note: Please refer to the Hints, Tips, & Pitfalls box on p. 258 about putting a 
delay in the program so the drawing appears on the window. Also, please 
refer to the You Might Want to Know box on p. 259 if you want the drawing 
to remain on the window (instead of disappearing when the window is 
minimized, for example). 

Level 3 Programming Exercises ★★★ 

17. At the end of movie credits you see the year movies are produced in Roman 
numerals, for example, MCMXCVII for 1997. To help the production staff 
determine the correct Roman numeral for the production year, write a 
program that reads a year and displays the year in Roman numerals. 


Roman Numeral Number 

I 1 

V 5 

X 10 

L 50 

C 100 

D 500 

M 1000 


Remember that certain numbers are expressed by using a “subtraction,” for 
example, IV for 4, CD for 400, and so forth. 

Development Exercises 

For the following exercises, use the incremental development methodology to 
implement the program. For each exercise, identify the program tasks, create 
a design document with class descriptions, and draw the program diagram. 

Map out the development steps at the start. Present any design alternatives and 
justify your selection. Be sure to perform adequate testing at the end of each 
development step. 
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18. MyJava Coffee Outlet (see Exercise 29 from Chap. 3) decided to give 
discounts to volume buyers. The discount is based on the following 
table: 


Order Volume 

Discount 

25 bags 

5% of total price 

> 50 bags 

10% of total price 

> 100 bags 

15% of total price 

> 150 bags 

20% of total price 

> 200 bags 

25% of total price 

> 300 bags 

30% of total price 


Each bag of beans costs $5.50. Write an application that accepts the number 
of bags ordered and prints out the total cost of the order in the following 
style: 


Number of Bags Ordered: 173 - $ 951.50 
Discount: 

20% - $ 190. 30 

Your total charge is: $ 761.20 

19. Combine Exercises 18 and 25 of Chap. 3 to compute the total charge 
including discount and shipping costs. The output should look like the 
following: 


N u mb e r 

of Bags Order ed: 

43 - $ 236 

. 50 


Discount: 

5% - $ 11. 

83 


Boxes Used: 

1 Large - 

2 Medium - 

$1.80 

$2.00 

Your 

total charge is: 

$ 228. 47 



Note: The discount applies to the cost of beans only. 

20. You are hired by Expressimo Delivery Service to develop an application 
that computes the delivery charge. The company allows two types of 
packaging—letter and box—and three types of service—Next Day Priority, 
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Next Day Standard, and 2-Day. The following table shows the formula for 
computing the charge: 


Package 

Type 

Next Day 

Priority 

Next Day 

Standard 

2-Day 

Letter 

$12.00, up to 8 oz 

$10.50, up to 8 oz 

Not available 

Box 

$15.75 for the first 

$13.75 for the first 

$7.00 for the first 


pound. Add $1.25 

pound. Add $1.00 

pound. Add $0.50 


for each additional 

for each additional 

for each additional 


pound over the first 

pound over the first 

pound over the first 


pound. 

pound. 

pound. 


The program will input three values from the user: type of package, type of 
service, and weight of the package. 

21. Ms. Latte’s Mopeds ‘R Us rents mopeds at Monterey Beach Boardwalk. To 
promote business during the slow weekdays, the store gives a huge discount. 
The rental charges are as follows: 


Moped Type 

Weekday Rental 

Weekend Rental 

50cc Mopette 

$15.00 for the first 3 h, 

$30.00 for the first 3 h, 


$2.50 per hour after the 

$7.50 per hour after the 


first 3 h. 

first 3 h. 

250cc Mohawk 

$25.00 for the first 

$35.00 for the first 3 h, 


3 h, $3.50 per hour after 

$8.50 per hour after the 


the first 3 h. 

first 3 h. 


Write a program that computes the rental charge, given the type of moped, 
when it is rented (either weekday or weekend), and the number of hours 
rented. 

22. Write a program that teaches children how to read a clock. Input the hour 
and minute. Accept only numbers between 0 and 12 for hour and between 0 
and 59 for minute. Print out an appropriate error message for an invalid input 
value. Draw a clock that looks something like this: 



To draw a clock hand, you use the drawLine method of the Graphics class. 
The endpoints of the line are determined as follows: 
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The value for constant K determines the length of the clock hand. Make the 
K larger for the minute hand than for the hour hand. The angle 0 is expressed 
in radians. The angle 0 mm of the minute hand is computed as 

(90 - Minute X 6.0) — 

180 


and the angle 0 hr of the hour hand is computed as 



^Hour + 


Minute \ 

60.0 j 


X 30.0 


77 

180 


where Hour and Minute are input values. The values 6.0 and 30.0 designate 
the degrees for 1 min and 1 h (i.e., the minute hand moves 6 degrees in 
1 min and the hour hand moves 30.0 degrees in 1 h). The factor 77 /180 
converts a degree into the radian equivalent. 

You can draw the clock on the content pane of a frame window by 
getting the content pane’s Graphic object as described in the chapter. Here’s 


some sample 

code 





i mp 

ort 

j av 

a x. s wi 

ng. *; 



i mp 

ort 

j av 

a, a wt. 

*; II f 

or 

Gr a phi c s 

J F r 

a me 


wi n; 




Con 

t a i 

ne r 

cont en 

t P a n e; 



Gr a 

p h i 

c 5 

g; 




wi n 

_ 

new 

j F r a me 

0; 



wi n 

. s e 

t Si z 

e ( 300, 

3 0 0 ); 



wi n 

. s e 

t Loc 

at i 0 n ( 

100, 10 

0); 


wi n 

. s e 

t Vi s 

i b 1 e (t 

rue); 



c 0 n 

t e n 

t Pan 

e = wi 

n. get C 

0 n t 

e nt Pa ne ( 

9 = 

c 0 

nt en 

t P a n e. 

get Gr a 

p h i 

cs( ); 

g. d 

r a wOv a 1 

(50, 50 

,2 0 0,2 

00) 

; 
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Note: Please refer to the Hints, Tips, & Pitfalls box on p. 258 about putting a 
delay in the program so the drawing appears on the window. Also, please 
refer to the You Might Want to Know box on p. 259 if you want the drawing 
to remain on the window (instead of disappearing when the window is 
minimized, for example). 

23. Extend the application in Exercise 22 by drawing a more realistic, better- 
looking clock, such as this one: 



Note: Please refer to the Hints, Tips, & Pitfalls box on p. 258 about putting a 
delay in the program so the drawing appears on the window. Also, please 
refer to the You Might Want to Know box on p. 259 if you want the drawing 
to remain on the window (instead of disappearing when the window is 
minimized, for example). 

24. After starting a successful coffee beans outlet business, MyJava Coffee 
Outlet is now venturing into the fast-food business. The first thing the 
management decides is to eliminate the drive-through intercom. MyJava 
Lo-Fat Burgers is the only fast-food establishment in town that provides a 
computer screen and mouse for its drive-through customers. You are hired as 
a freelance computer consultant. Write a program that lists items for three 
menu categories: entree, side dish, and drink. The following table lists the 
items available for each entry and their prices. Choose appropriate methods 
for input and output. 


Entree 


Side Dish 


Drink 


Tofu Burger 

$3.49 

Rice Cracker 

$0.79 

Cafe Mocha 

$1.99 

Cajun Chicken 

$4.59 

No-Salt Fries 

$0.69 

Cafe Latte 

$1.99 

Buffalo Wings 

$3.99 

Zucchini 

$1.09 

Espresso 

$2.49 

Rainbow Fillet 

$2.99 

Brown Rice 

$0.59 

Oolong Tea 

$0.99 
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After you have read and studied this chapter,you 
should be able to 

• Implement repetition control in a program 
using while statements. 

• Implement repetition control in a program 
using do-while statements. 

• Implement a generic loop-and-a-half 
repetition control statement. 

• Implement repetition control in a program 
using for statements. 

• Nest a loop repetition statement inside 
another repetition statement. 

• Choose the appropriate repetition control 
statement for a given task. 

• (Optional ) Write simple recursive methods. 

• Format output values by using the Formatter 
class. 
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Introduction 



repetition 

statements 


recursive 

method 


he selection statements we covered in Chapter 5 alter the control flow of a program. 
In this chapter we will cover another group of control statements called repetition 
statements. Repetition statements control a block of code to be executed for a fixed 
number of times or until a certain condition is met. We will describe Java's three 
repetition statements: while, do-while, and for. Finally, in optional Section 6.11, we 
will describe recursive methods. A recursive method is a method that calls itself. 
Instead of a repetition statement, a recursive method can be used to program the 
repetition control flow. 


while state¬ 
ment syntax 


6.1 


The while Statement 


Suppose we want to compute the sum of the first 100 positive integers 1,2, , 100. 
FI ere's how we compute the sum, usi ng a while statement: 


int sum = 0, number =1; 

while (number <= 100) { 
sum =sum+number; 
number = number + 1; 

} 

Let's analyze the while statement. The statement follows the general format 


while ( < b o o I e a n expressi on> ) 
<s t a t e me n t > 


where <statement> is either a <single statements or a <compound statements The 
<statement> of the sample while statement is a Compound statement and there¬ 
fore has the left and right braces. Repetition statements are also called loop state- 
loop body merits, and we characterize the <statement> as the loop body. Figure 6.1 shows how 
this while statement corresponds to the general format. As long as the cboolean 
expression;* is true, the loop body is executed. Figure 6.2 is a diagram showing the 
control flow of the sample code. 

Let's modify the loop so this time we keep on adding the numbers 1, 2, 3, and 
so forth, until the sum becomes more than 1,000,000. FI ere's how we write the while 
statement: 


int sum = 0, number =1; 

whi Ie ( s urn <= 1 0 0 0 0 0 0 ) { 
sum =sum+number; 
number = number + 1; 

} 
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Boolean Expression |-1 

vhl I e ( f number <=100 J ) 
sum = sum + number; 
number = number + 1; 

. } 

Figure 6.1 Correspondence of the example while statement of the general format. 


Statement 
(loop body) 


b 




Figure 6.2 A diagram showing the control flow of a while statement. 


Notice how the <boolean expression> is modified, and it is the only part of the while 
statement that is modified. 

Let's try another example. This time, we compute the product of the first 
20 odd integers. (Note: The ith odd integer is 2 * i — i. For example, the fourth odd 
integer is 2 * 4 -1 =7.) 

int product = 1, number = 1, count = 20, lastNumber; 

I ast Number = 2 * count - 1; 

while (number <= lastNumber) { 
product = product * number; 
number = number +2; 

} 

count- The first and the third sample while statements are called count-controlled 

controlled loop / 00 p S because the loop body is executed for a fixed number of times (as if we were 

counting). 


www.it-ebooks.info 























306 


Chapter 6 Repetition Statements 


Improving User Interface with a Loop 

Now let's study how the repetition control in the program will improve the user in¬ 
terface of the program. In earlier sample programs, we assumed the input data were 
valid. The programs we have written may produce wrong results or simply stop run¬ 
ning if the user enters an invalid value. Assuming that the input values are valid 
makes the writing of programs easier because we do not have to write code to han¬ 
dle the invalid values. Although it is easier for us to write such programs, it would 
be an inferior interface from the user's standpoint. Requiring the user to make no 
mistake in entering input values is too restrictive and not user-friendly. We need to 
develop programs that are more user-friendly. Imagine you successfully entered 
19 values, but on the 20th input value, you mistyped. A user-hostile program would 
stop, and you would have to run the program again. A more user-friendly program 
would allow you to reenter a correct 20th value. 

All we could have done using a selection statement was either to print out an 
error message or to set a default value if the user enters an invalid value. In the 
inputshapeType method of the Chapter 5 sample development, for example, if the 
user enters any invalid value, we set the shape type to ellipse. Instead of quitting 
the program after displaying an error message or continuing the program with a de¬ 
fault value, it would be better in general to allow the user to reenter the value until 
the correct value is entered. We need a repetition control to achieve this. 

Let's look at an example. Suppose we want to input a person's age, and the 
value must be between o and 130. We know the age cannot be negative, so the age 
input must be greater than or equal to o. We set the upper bound to 130 to take into 
account the possibility of some long-living human beings in a remote hamlet in 
Timbuktu. Let's say we will let the user enter the age until a valid age is entered. We 
can code this repetition control, using a while statement: 


Scan 

ner scanner = new 

Scanne 

r ( S 

y s t e m. i 

n); 


i nt 

age; 






Syst 

em. out. pri n t ( " Y o u r 

Age ( 

bet 

ween 0 

and 

130 

age 

= scanner.nextl nt( 

); 





whi 1 

e (age < 70 || age 

> 130 

) { 





System, out. pri ntl n 

( 






"An invalid ai 

ge was 

e n i 

t er ed, 

PI ea 

s e l 


System, out.print ( 

"Your 

Age 

( bet we 

e n 0 

a m 

} 

age = scanner.next 

1 nt () ; 





Notice that we included the statements 





Syst 

em, out. pri nt("Your 

Age ( 

bet 

ween 0 

and 

130 

age 

= scanner, nextl nt ( 

); 






to input the age before the while statement. Without this input statement, the vari- 
able age will not have a value when the boolean expression is evaluated for the very 
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priming read first time. This reading of a value before the testing is done is called a priming read. 
We will discuss this issue of priming read further in Section 6.4. 

As the second example, let's modify the inputShapeType method from 
Section 5.6. To refresh our memory, here's the original code: 

private Drawabl eShape.Type inputShapeType! ) { 

System, out. print) "Selection: Enter the Shape numberin' 1 + 

" 1 -Ellipse \n"+ 

" 2 - Rectangle \n" + 

" 3 - Rounded Rectangle \n“); 

i nt selection = scanner. nex11 nt ( ) ; 


Drawabl eShape. Type type; 
switch (selection) { 


case 1: 

type = 

break; 

Drawabl eShape,Type. ELLI PSE; 

case 2: 

type = 

break; 

Drawabl eShape.Type. RECTANGLE; 

case 3: 

type = 

break; 

Dr awabl eShape.Type. ROUNDED,RECTANGLE 

default: 

type = 

Drawabl eShape. Type. ELLI PSE; 

} 

return type; 

break; 



} 

To allow the user to reenter the value until the valid entry is made, we can modify 
the method to the following: 


private int inputShapeTypef ) { 

i nt selection = get Selection!); 

Drawabl eShape.Type type; 
s wi t c h (selection) { 


getSelection is defined 
after this method. 



case 

1: 

type = Drawabl eShape.Type, ELLI PSE; 
break; 


case 

2: 

type = Drawabl eShape.Type, RECTANGLE; 

break; 

This default case should 
never happen if getSelection 

case 

3: 

type = Drawabl eShape.Type. ROUNDED_RECTANGLE 

break; 

is implemented correctly.We 
put this here to catch any 
internal coding error. 

default: 

System, out. pri ntl n 

(“Internal Error: Proceed with Default"); 
type = Drawabl eShape.Type. ELLI PSE; 
break; 
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sentinel- 
controlled loop 


} 

return type; 

} 

private int getSel ecti on( ) { 
i nt selection; 

System, out. print! “Selection: Enter the Shape numberin'' + 

" 1 - Ellipse \ n" + 

" 2 - Rectangle \n“ + 

" 3 - Rounded Rectangle \n"); 

selection = scanner. nextlntf); 

while (selection < 1 || selection > 3) { 

System, out. pri ntl n ( 

"An invalid age was entered, Please try 
a g a i n. \ n" ); 

System, out. print! 11 Selection: Enter the Shape 
n u mb e r \ n" + 

1 - Ellipse \ n" + 

" 2 - Rectangle \ n" + 

" 3 - Rounded Rectangle \n"); 

selection = scanner, n e x 11 n t () ; 

} 

return selection; 

} 

The next example keeps reading in integers and computes their running sum 
until a negative number is entered. 

int sum = 0; number; 

Scanner scanner = new Scanner(System. In); 

System, out. print! "Enter integer "); 
number = scanner, nextI nt (); 
while (number >= 0) { 
sum = sum + number; 

System, out. print! "Enter integer "); 
number = scanner, nex11 nt (); 

} 

The previous three sample while statements are called sentinel-controlled 
loops. With a sentinel-controlled loop, the loop body is executed repeatedly until 
any one of the designated values, called a sentinel, is encountered. The sentinels for 
the three examples, respectively, are any value between 0 and 130, any value from 
1 to 3, and any negative number. 


www.it-ebooks.info 


6.1 The while Statement 309 


Sample Program with a Loop 

Let's write a short sample program that illustrates the use of a while statement. It is 
a well-known fact that students in college do not get enough sleep, some studying 
hard while others are enjoying life too much. Which dorm they live in also makes a 
huge difference, so let's develop a program that determines the average sleeping 
time of the residents in a given dorm. This information can be made available on the 
housing office website so the students can make an informed decision on which 
dorm to choose for the next academic year. 

Using Scanner, first we will input the dorm name. Then we loop and input the 
length of sleep of the residents until the input value of zero is entered. When the 
input is done, the average sleep time is displayed. We use zero as a sentinel value in¬ 
stead of a negative number such as-1 because we do not want to consider a zero as 
a valid entry. Here's the program listing: 



Chapter 6 Sample Program: Sleep Statistics for Dorm Residents 


File: Ch6SI eepStati sti cs.j ava 

*/ 

import java,text.*; 
import java.util.*; 

class Ch6SI eepStatisti cs { 

private Scanner scanner: 

public static void main (String!) args) { 

Ch6SI eepStati stics prog = new Ch6SI eepStati stics ( 
prog, st ar t ( ) ; 


} 


public Ch6SI eepStatisti cs() { 


Constructor 

scanner = new Scanner ( System, in): 



scanner. useDel i mi ter(System. getPropertyl" 

} 

i ne.separator")): 

public void s t a r t ( ) { 


start 


double sleepHour, sum = 0: 
i nt c nt =0: 


//enter the dorm name 

System, out. pri nt("Dorm n a me: " ) ; 

String dorm = scanner, n ext ( ) : 

II Loop: get hours of sleep for each resident 
II until 0 is entered. 

sleepHour = get Double! “Enter sleep hours (0 - to stop:"): 
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while (si eepHour ! = 0) { 

sum += sI eepHour; 
c nt ++; 


sleepHour = get Doubl e( " Enter sleep hours (0 - to stop):"); 

} 

if (cnt == 0) { 

System, out. println ("No Data Entered"); 

} else { 


Deci ma I Format df = new Dec i mal For mat (" 0. 00" ) ; 
System, out. pri ntl n( 

"Average sleep time for " + 
dorm + " is \n\n " + 

df.format(sum/cnt) + " hours. 1 '); 

} 

} 


private double getDouble(String message) 
double result; 


getDouble 


Sy s t em, o ut. p r i nt ( mes s a ge ) ; 
result = scanner.next Doublet); 
return result; 



Finding the Greatest Common Divisor 

Let's close this section with a slightly more complicated example of using a loop 
statement. In Section 5.4, we defined the equals method for the Fraction class. We 
indicated that the fully functional equals method needs to call another method to re¬ 
duce a fraction to its simplest from (e.g., the simplest form of 16/32 is 1/2). To sim¬ 
plify a fraction, we need to find the greatest common divisor of its numerator and 
denominator. For example, the greatest common divisor of 16 and 32 is 16. Divid- 
i ng both the numerator and the denomi nator by thei r greatest common denomi nator 
will reduce the fraction to its simplest form. Here we will define a method that 
returns the greatest common divisor of two given arguments. [Note: We will de¬ 
velop a full definition of the Fraction class in Chapter 7 when we introduce additional 
concepts on programmer-defined classes.) 

We will first provide a brute-force solution (inelegant) and then a clever solu¬ 
tion based on the Euclidean algorithm (elegant). The brute-force approach derives 
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the solution by applying the definition of greatest common divisor directly. Given 
two positive integers M and N, where M < = N, we find their greatest common divi¬ 
sor by dividing M and N with values from i to M. The last integer that divided both 
M and N perfectly (i.e., there is no remainder), is the greatest common divisor. 
Consider 24 and 36, for example. The numbers that divide 24 and 36 perfectly are 
1, 2, 3, 4, 6, and 12. So the greatest common divisor is 12. The fraction 24/36 is re¬ 
duced to its simplest form 2/3 by dividing 24 and 36 by 12. We can see if a number j 
divides another number i perfectly by using the modulo arithmetic. If i % j == o, then j 
divides i perfectly because the remainder of the division is o. 

H ere's the brute-force method: 

public int gcd_bruteforce(int m, int n) { 

/ / a s s u me m, n >= 1 

int last = Ma t h. mi n ( m, n ); 

int gc d; 

int i =1; 

while (i <= last) { 

if ( m % i == 0 && n % i == 0) { 
gc d = i; 

} 

i ++: 

} 

return g c d; 

} 

Now let's study an elegant solution based on the Euclidean algorithm. We 
begin with an example. Consider two positive integers 44 and 16. We will use the 
notation gcd(a, b) to stand for the greatest common divisor of a and b. Notice that 
gcd(44, 16) = 4. Here's how the Euclidean algorithm works. First divide 44 by 16. 
The remainder is 12. We have the relation 

44 = 2 * 16 + 12 

From this, we can conclude that the greatest common divisor G that divides 44 and 
16 must also divide 12. If it doesn't, then we get a contradiction. If a number G can 
divide 16 perfectly but cannot divide 12 perfectly, then 44 % G = (2*16 + 12) % G 
will result in a nonzero value. This is a contradiction. So now we can reduce the 
problem of finding gcd(44,16) to gcd(i6,12). We repeat the process. 

16 = 1 * 12 + 4 

Now we reduce the problem to gcd(i2, 4). Since 

12 = 3 * 4 + 0 
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shows no remainder, we finish the process and return the answer 4 as the 
greatest common divisor. The sequence of reduction is gcd(44, 16) = gcd(i6,12) = 
gcd(12, 4) = 4. 

How do we translate this concept into a working code? Let's map out the 
sequence of reductions graphically: 


N M R = N % M 


gcd(44,16) 44 % 16 = 12 

gcd(16,12) 16 % 12 = 4 

gcd(12,4) 12 % 4 = 0 


From this diagram, we see that M atone stage becomes N in the next stage and the 
remainder R becomes M in the next stage. We repeat this process until the remain¬ 
der becomes o. The value of M (4 in this example) at the end of the repetition is the 
greatest common divisor. Here's thegcd method that implements this idea: 

public int gcdfint m, int n) { 

II it doesn't matter which of n and mis bigger 

II this method will work fine either way 

/ / a s s u me m, n >= 1 

int r = n % m; 

whiI e ( r ! =0 ) { 

n = m; 
m = r; 
r = n % m; 

} 

return m; 

} 

Here’s how we trace the repetition: 


Repetition 

Count 

n 

m 

r 

0 

44 

16 

12 

1 

16 

12 

4 

2 

12 

4 

0 


The first column indicates the number of times the while loop is executed. So the 
first row shows the values of n, m, and rafter zero repetitions, that is, before the while 
statement is executed. The third row shows the values after the second repetition is 
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completed. At the point where the third repetition is attempted, thevalueof r is o, so 
the while loop is terminated and thevalueof m, which is 4, is returned. 

The two versions of finding the greatest common denominator produce the 
correct results. If they both produce the same results, which version shall we prefer? 
The brute-force method is probably a lot easier to understand, at least initially, be¬ 
cause it reflects the definition of greatest common divisor clearly. We always prefer 
the one that is clearer and easier to understand, but only when their performances 
are relatively the same. In this example, the Euclidean gcd method far outperforms 
the gcd_bruteforce method. In other words, the Euclidean gcd method finds the 
solution much faster than gcd_bruteforce. And the gap widens dramatically when 
the values of M become large.We will analyze the performance of these two meth¬ 
ods experimentally by recording their execution times in Section 6.10. 

Quick 

CHECK 

1. Write a while statement to add numbers 11 through 20. Is this a count- 
controlled or sentinel-controlled loop? 

2. Write a while statement to read in real numbers and stop when a negative 
number is entered. Is this a count-controlled or sentinel-controlled loop? 

infinite loop 

6.2 Pitfalls in Writing Repetition Statements 

No matter what you do with the while statement (and other repetition statements), 
make sure that the loop will eventually terminate. Watch outforan infinite loop such 
as this one: 

i nt product =0; 

while (product < 500000) { 
product = product * 5; 

} 

Do you know why this is an infinite loop? The variable product is multiplied by s 
in the loop body, so the value for product should eventually become larger than 
500000, right? Wrong. The variable product is initialized to o, so product remainso. 
The boolean expression product < sooooo will never be false, and therefore this 
while statement is an infinite loop. You have to make sure the loop body contains a 
statement that eventually makes the boolean expression false. 

H ere's another example of an infinite loop: 

int count = 1; 

while (count ! = 10) { 
count = count + 2; 

} 

Since the variable count is initialized to i and the increment is 2, count will 
never be equal to io. Note: In theory, this while statement is an infinite loop, but 
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overflow error 

in programming languages other than Java, this loop will eventually terminate 
because of an overflow error, An overflow error will occur if you attempt to 
assign a value larger than the maximum value the variable can hold. When an 
overflow error occurs, the execution of the program is terminated in almost all 
programming languages. With Java, however, an overflow will not cause program 
termination. When an overflow occurs in Java, a value that represents infinity 
(IEEE 754 infinity, to be precise) is assigned to a variable and no abnormal ter¬ 
mination of a program will occur. Also, in Java an overflow occurs only with 
float and double variables; no overflow will happen with int variables. When you 
try to assign a value larger than the maximum possible integer that an int variable 
can hold, the value "wraps around" and becomes a negative value. 

W hether the 1 oop termi nates or not because of an overflow error, the 1 ogi c of the 
loop is still an infinite loop, and we must watch out for it. W hen you write a loop, you 
must make sure that the boolean expression of the loop will eventually become false. 

Another pitfall for you to avoid is the using of real numbers for testing and 
increment. Consider the following two loops: 

imprecise loop 
counter 

II Loop 1 

double count = 0.0; 

while (count ! = 1.0) 

count = count + 0. 333333333333333; 

//there are fifteen 3s 

II Loop 2 

double count = 0.0; 

whi 1e (count != 1.0) 

count = count + 0. 3333333333333333; 

//there are sixteen 3s 

T he second while termi nates correctly, but the fi rst while is an i nfi nite loop. W hy the 
difference? Because only an approximation of real numbers can be stored in a com¬ 
puter. We know in mathematics that 

1 1 1 

3 + 3 + 3 

is equal to 1. However, in a computer, an expression such as 

1. 0/ 3. 0 + 1. 0/ 3. 0 + 1. 0/ 3. 0 

may or may not get evaluated to i.o, depending on how precise the approximation is. 

The problem here is not that the number 1/3 is a repeating decimal. A decimal 
number such as 0.1 cannot be stored precisely in a computer memory either. Con¬ 
sider the following example: 

double count = 0.0; 

while (count ! = 1.0) { 
count = count +0.10; 

} 
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This repetition statement looks simple enough. We initialize count to o.o and re¬ 
peatedly add o.io to it, so after 10 repetitions, the loop should terminate. Wrong. 
The counter variable count never becomes equal to i.o. The closest it gets is 
0.9999999999999999. Let's change the loop to 

double count = 0.0; 

while (count <= 1.0) { 
count = count +0.10; 

System, out. pri ntl n(count); 

} 

so we can seethe values assigned to count. Here's the output from this code: 

o. 1 
0 . 2 

0. 30000000000000004 
0. 4 
0 . 5 
0 . 6 
0. 7 

0. 7999999999999999 
0. 8999999999999999 
0. 9999999999999999 
1. 0999999999999999 

As these examples illustrate, we should avoid using real numbers as counter vari¬ 
ables because of the imprecision. 


ings to Remember 

Avoid using real numbers for counter variables as much as possible. If you use them, 
then be aware of the pitfall and ensure that the loop terminates. 


Another thing to watch outfor in writing a loop i s the off-by-2 error. Suppose 
we want to execute the loop body 10 times. Does the following code work? 

count =1; 

while (count < 10 ) { 
c o u n t ++; 

} 

No, the loop body is executed 9 times. How about the following code? 

count = 0; 

whiIe (count <= 10 ) { 
c o u n t ++; 

} 
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No, this time the loop body is executed 11 times. The correct while loop is 

count =0; 

while (count < 10 ) { 
count ++; 

} 


count =1; 

whiIe (count <= 10 ) { 
count ++; 

} 

Yes, we can write the desired loop as 

count =1; 

while (count != 10 ) { 


count ++; 

} 

but this condition for stopping the count-controlled loop is dangerous. We already 
mentioned about the potential trap of an infinite loop. In summary, 



lings to Remember 

Watch out for the off-by- 7 error (OBOE). 


C\\ou 
Might 
Want to 

Know 


To show you just how commonly the off-by-1 error occurs in everyday life, con¬ 
sider the following two questions. When you want to put a fencepost every 10 ft, 
how many posts do you need for a 10O-ft fence? If it takes 0.5 s for an elevator to 
rise one floor, how long does it take to reach the fourth floor from the first level? 
The answers that come immediately are 10 posts and 2 s, respectively. But after a 
little more thought, we realize the correct answers are 11 posts (we need the final 
post at the end) and 1.5 s (there are three floors to rise to reach the fourth floor 
from the first level). 


Another common mistakemadeby beginning programmers istheinclusion of 
avoidable test in a loop. Consider the following loop statement: 

i nt oddSum = 0; 
int evenSum = 0; 
i nt n um = 1; 
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while (num < 1001) { 

if (num / 2 == 0) { //even # 
evenSum = evenSum + num; 

} else { II odd # 

oddSum = oddSum + num; 

} 

num = num + 2; 

} 

The code computes the sum of even numbers and the sum of odd numbers between 
1 and 1000, inclusive. To compute the two sums, the if test is executed 1000 times. 
Is it necessary? No. We can compute the two sums more efficiently by writing two 
separate loops: 

int oddSum = 0; 
int evenSum = 0; 
i nt num = 1; 

while (num < 1001) { 

oddSum = oddSum + num; 

num = num + 2; 

} 

num = 2; 

while (num < 1001) { 

evenSum = evenSum + num; 
num = num + 2; 

} 

We can improve the code even further by usign only one loop as follows: 

int oddSum = 0; 
int evenSum = 0; 
int num = 1; 

while (num < 1001) { 

oddSum = oddSum + num; 

evenSum = evenSum + (num + 1); 

num = num + 2; 

} 


This test can be avoided by 
writing two loops. 
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And here are the points for you to remember in writing a loop. 


LjQlings to Remember 

The checklist for the repetition control: 

1. Make sure the loop body contains a statement that will eventually cause the 
loop to terminate. 

2. Make sure the loop repeats exactly the correct number of times. 

3. If you want to execute the loop body N times, then initialize the counter to 0 
and use the test condition counter <Nor initialize the counter to I and use the 
test condition counter < = N. 


W 

1. Which of the following is an infinite loop? 

a. int sum = 0, i =0; 
while ( i >= 0 ) { 

sum += i ; 
i ++; 

} 

b. int sum = 0, i =100; 
while ( i ! = 0 ) { 

sum += i ; 
i - -; 

} 

2 . For each of the following loop statements, determine the value of sum after the 
loop is executed. 

a. i nt count =0, s um = 0; 
while ( count < 10 ) { 

sum += count; 
count ++; 

} 

b. int count =1, sum = 0; 
whi I e ( count <= 30 ) { 

sum += count; 
count += 3; 

} 

c. int count =0, sum = 0; 
while ( count <20 ) { 

sum += 3 * c o u n t; 
count += 2; 

} 
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pretest loop 


posttest loop 

do-while 

statement 

do-while 

syntax 


6.3 The do-while Statement 

The while statement is characterized as a pretest loop because the test is done before 
execution of the loop body. Because it is a pretest loop, the loop body may not be ex¬ 
ecuted at all. The do-while is a repetition statement that is characterized as a posttest 
loop. With a posttest loop statement, the loop body is executed at least once. 

The general format for the do-while statement is 

do 


<st at ement > 

while ( < b o o I e a n expression ) ; 

T he <statement> i s executed unti I the <boolean expression becomes false. R emem- 
ber that <statement> is either a <single statement or a <compound statements 
We will adopt the same policy for the if statement; that is, we will use the syntax of 
<compound statement even if there is only one statement in the loop body. In 
other words, we will use the left and right braces even if the loop body contains only 
one statement. 

Let's look at a few examples. We begin with the second example from 
Section 6.1, which adds the whole numbers 1, 2, 3,... until the sum becomes larger 
than 1,000,000. Here's the equivalent code in a do-while statement: 

int sum=0, number =1; 

do { 

sum += number; 
number ++; 

} while ( sum<= 1000000 ); 


Figure 6.3 shows how this do-while statement corresponds to the general format, 
and Figure 6.4 is a diagram showing the control flow of this do-while statement. 

L et's rewrite the routi ne that i nputs a person's age by usi ng the do-while state¬ 
ment. H ere's our first attempt: 

do { 

System, out. print! "Your Age (between 0 and 130): "); 
age = scanner. nextlntf); 

} while (age < 0 || age > 130); 

11 works, but uni i ke the versi on usi ng the while statement, the code does not di spl ay 
an error message. The user could be puzzled as to why the input is not accepted. 
Suppose the user tries to enter 130 but actually enters 139 unintentionally. Without 
an error message to inform the user that the input was invalid, he or she may won¬ 
der why the program is asking again for input. A program should not be confusing 
to the user. We must strive for a program with a user-friendly interface. 
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Statement 
(loop body) 


do ! { ! 

sum += number; | 

number++; j i Boolean Expression 


}j \rthi I e ( j sum <= 1000000 j ); 


Figure 6.3 Correspondence of the example do-while statement to the general format. 



Figure 6.4 A diagram showing the control flow of the do-while statement. 


To display an error message, we rewrite the do-while statement as 
do { 

System, out. print! "Your Age (between 0 and 130): "); 

age = scanner. nextlntf); 

if (age <0 || age >130) { 

System, out. println! 

"An invalid age was entered, Please try again."); 

} while (age < 0 || age > 130); 

This code is not as good as the version using the while statement. Do you know 
why? This do-while statement includes an if statement inside its loop body. Since 
the loop body is executed repeatedly, it is important not to include any extraneous 
statements. The if statement is repeating the same boolean expression of the 
do-while. Duplicating the testing conditions tends to make the loop statement 
harder to understand. For this example, we can avoid the extra test inside the loop 
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boolean vari¬ 
able and loop 


body and implement the control flow a little more clearly by using a while state¬ 
ment. In general, the while statement is more frequently used than the do-while 
statement. However, the while statement is not universally better than the do-while 
statement. It depends on a given task, and our job as programmers is to use the most 
appropriate one. We choose the repetition statement that implements the control 
flow clearly, so the code is easy to understand. 

When you have multiple conditions to stop the loop and you need to execute 
different responses to each of the multiple conditions, then the use of boolean 
variables often clarifies the meaning of the loop statement. Consider the following 
example. Suppose we need to compute the sum of odd integers entered by the user. 
We will stop the loop when the sentinel value o is entered, an even integer is en¬ 
tered, or the sum becomes larger than 1000. Without using any boolean variables, 
we can write this loop as follows: 

sum = 0; 

do { 

System, out, print! "Enter integer: "); 

num = scanner. nextlntf); 

if ( num == 0) {//sentinel 

System, out. print! "Sum = " + sum); 

} else if (num % 2 = = 0 ) //invalid data 

System, out. print! "Error: even number was entered"); 

} else { 

sum += num; 

if (sum > 1000) { II pass the threshold 

System, out. print! "Sum became larger than 1000 "); 

} 

} 

} while ( ! ( n u m % 2 == 0 || num==0 || sum > 1000) ); 

The ending condition is tricky. We need to stop the loop if any one of the three 
conditions num % 2 == 0, num == o, or sum > 1000 is true. So we repeat the loop 
when none of the three conditions are true, which is expressed as 

! ( num % 2 == 0 | | num == 0 || sum > 1 0 0 0 ) 

We can also state the condition as 

do { 


Note: 

!(a || b) is equal to (!a &&!b) 
v___ 


} while! num%2 ! = 0 && num ! = 0 && sum<= 1000 ); 

which means "repeat the loop while num is odd and num is not 0 and sum is less 
than or equal to 1000." Regardless of the method used, the test conditions are 
duplicated inside the loop body and in the boolean expression. 
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Now, by using a boolean variable, the loop becomes 

Note: continue is a 

boolean repeat - true, reserved word in Java, 

„ while repeat is not. 

sum = 0; 

do { 

System, out. print) “Enter integer: "); 

num = scanner. nextlntf); 

if (num % 2 = = 0 ) { //invalid data 

System, out. print! “Error: even number was entered"); 
repeat = false; 

} else if (num == 0) { //sentinel 
System, out. print! “Sum = " + sum); 
repeat = false; 

} else { 

sum += num; 

if (sum > 1000) { II pass the threshold 

System, out. print! “Sum beca me larger than 1000 “); 
repeat = false; 

} 

} 

} while ( repeat ); 

This loop eliminates duplicate tests. The use of boolean variables is helpful in mak¬ 
ing loop statements readable, especially when the loop has multiple stop conditions. 

As the last example of this section, here's the gcd method implemented by using 
the do-while statement (we'll call it gcd_do to differentiate it from other versions): 


Set the variable to 
false so the loop 
terminates. 


public int gc d_ do ( i nt m, int n) { 

II it doesn't matter which of n and mis bigger 
II this method will work fine either way 

/ / a s s u me m, n >= 1 

int r ; 
do { 

r = n % m; 
n = m; 


m 


r; 


} whi I e (r ! = 0) ; 


return 


} 


//NOTE: we're returning n, not m 
II because m == r == 0 after the loop 
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w 

Quick 

CHECK 

V 


loop-and-a-half 

control 


1. Write a do-while loop to compute the sum of the first 30 positive odd integers. 

2. Rewrite the following while loops as do-while loops. 

a. int count =0, sum=0; 
while ( count <10 ) { 

sum += count; 
c o u n t ++; 

} 

b. int count = 1, sum=0; 
wh iIe ( count <= 30 ) { 

sum += count; 
count += 3; 

} 


6.4 Loop-and-a-Half Repetition Control 

When we compare the while and do-while repetition control, we realize the key dif¬ 
ference is the position of the testing relative to the loop body. The while loop tests 
the terminating condition before the loop body, but the do-while tests the terminat¬ 
ing condition after theloop body. What happens when we want to test the terminat¬ 
ing condition right in the middle of the loop body? Such repetition control can be 
characterized as a loop-and-a-half control because only the top half of the loop body 
is executed for the last repetition. Do we ever need such a looping statement? 
Consider the following while loop with the priming read: 

String n a me; 

S y s t e m. o u t. p r i n t ( 11 Y o u r n a me: " ) ; 

name = scanner. next)); 

while (name.length!) == 0) { 

System, out. p r i n 11 n ( " Invalid entry. " + 

"You must enter at least one character."); 

System, out. pri nt("Your n a me: 11 ) ; 

name = scanner, next (); 

} 

Because the while loop tests the terminating condition at the beginning, we must 
place some statements before the loop to ensure the condition can be evaluated. The 
same statements are repeated inside the loop, so the terminating condition can be 
evaluated correctly after each repetition. This duplication of the statements can 
become tedious depending on whatisto beduplicated. Wecan avoid the duplication 
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of code with the loop-and-a-half structure. Java does not support any special re¬ 
served word for the loop-and-a-half repetition control. Rather, we implement it 
using the while, if, and break reserved words. Here's how we express the sample 
priming read while loop in a loop-and-a-half format: 

String n a me; 

while (true) { 

System, out. pri nt("Your n a me: " ); 

name = scanner. next(); 

if (na me. length!) == 0) break; 

System, out. pri n 11 n ( " Invalid entry. " + 

"You must enter at least one character. "); 

} 

We have seen the use of the break statement in Chapter 5. Execution of the 
break statement causes the control to jump out of the switch statement. We can in 
fact use the break statement with any control statement. I n this example, the break 
statement causes the control to jump out of the while statement. Since it is executed 
when the if test is true, the string variable name contains at least one character. If 
the test fails, the next statement is executed and the control loops back to the top of 
the while loop. Expressing this control flow in a flowchart will result in the one 
shown in Figure 6.5. 

There are two concerns when we use the loop-and-a-half control. The first is 
the danger of an infinite loop. Notice the boolean expression of the while state¬ 
ment is simply true, which, of course, will always evaluate to true. So, if we forget 
to include an if statement to break out of the loop, it will end up in an infinite loop. 


If the test evaluates 
to true, then jump 
out of the loop. 



Figure 6.5 A diagram showing the control flow of a loop-and-a-half statement. 
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The second concern is the complexity of multiple exit points. It is possible to write 
a loop-and-a-half statement with multiple break statements, something like this: 


while 

(true) 

{ 





i f 

( <condi 

t i 

o n 

1>) 

br 

ea k 

i f 

( <c o n di 

t i 

o n 

2 >) 

br 

ea k 

i f 

( <c ondi 

t i 

o n 

3 >) 

br 

ea k 


} 

It gets tricky to write a correct control loop with multiple exit points. One of the 
frequently cited software engineering practices for reliable code is to enforce the 
one-entry one-entry one-exit control flow. In other words, there is one entry point to the loop 

one-exit anc | one ex |t point from the loop. With the standard while and do-while with no 

contro1 break statements inside the loop, we have this one-entry one-exit control flow. A 

loop-and-a-half control with multiple break statements, however, violates it. 

If we watch out for these two points, a loop-and-a-half control can be quite 
handy and can make the code more readable. Here are the things to remember in 
using the loop-and-a-half control. 


L^f^ings to Remember 

The checklist for the loop-and-a-half control: 



1. To avoid an infinite loop, make sure the loop body contains at least one if 
statement that breaks out of the loop. 

2. To keep the control simple and easy to read, avoid using multiple if statements 
that break out of the loop. 

3. Make sure the loop is short to keep the control logic as self-evident as possible. 
(Notice this applies to all loop statements, but more so for a loop-and-a-half.) 


In this textbook, we will be using loop-and-a-half statements whenever ap¬ 
propriate, that is, whenever it makes the code more readable and clearer. Before we 
conclude this section, here's another loop-and-a-half statement. The loop evaluates 
the average score, and it terminates when the input is a negative number. 

i nt c nt = 0; 

double score, sum = 0.0; 

while (true) { 

System, out, print! "Enter score: "); 
score = scanner, next Double!); 
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if (score < 0) break; 
sum += score; 
c nt ++; 

} 

if ( cnt >0) { 

avg = sum / cnt; 

} else { 

//error: no input 

} 

Again, wewill usethegcd method as the last example. Here'sthegcd method 
using the loop-and-a-half repetition control (we'll call this version gcd_LaH): 

public int gcd_LaH( i nt m, int n) { 

II it doesn't matter which of n and mis bigger 
II this method will work fine either way 

/ / a s s u me m, n >= 1 

int r ; 

whiIe (true) { 

r = n % m; 
if ( r == 0) break; 
n = m; 
m = r; 

} 

return m; 

} 


Quick 

CHECK 

\/ 

V 


1. Translate the following while loop to a loop-and-a-half format. 

int sum = 0, num=l; 
whi I e ( num <= 50) { 
sum += num; 
n u m++; 

} 

2 . Translate the following do-while loop to a loop-and-a-half format. 

int sum = 0, num = l; 

do { 

sum += num; 
n u m++; 

} while (sum <= 5000); 
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6.5 The for Statement 

The for statement is the third repetition control statement and is especially suitable 
for count-controlled loops. Let's begin with an example. The following code com¬ 
putes the sum of the first 100 positive integers: 

i nt i , s um = 0; 

for ( i =1; i <=100; i + + ) { 

sum+= i; //equivalent to sum= sum+ i; 

} 

The general format of the for statement is 

for ( <i n i t i a I i z a t i o n >; < b o o I e a n expressions <update> ) 

<st at ement > 

Figure 6.6 shows the correspondence of the sample code above to the general 
format. The diagram in Figure 6.7 shows how this statement is executed. The vari- 
controi variable able i in the statement is called a control variable, and it keeps track of the number 


Boolean Expression 
Initialization - 1 


Update 


Statement 
(loop body) 


for ( I i = 1 ;; \ i <= 100 j; ! i++ ) ) \ { 


sum += i; 



Figure 6.6 Correspondence of the example for statement to the general format. 



Figure 6.7 A diagram showing the control flow of the example for statement. 
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of repetitions. In the sample code, the control variable i is first initialized to o, and 
immediately the boolean expression is evaluated. If the evaluation results in 
true, the loop body is executed. Otherwise, the execution of the for statement is 
terminated, and the control flows to the statement following this for statement. 
Every time the loop body is executed, the increment operator (i++) is executed and 
then the boolean expression is evaluated. 

The <initialization> component also can include a declaration of the control 
variable. We can do something like this 

for ( int i =1; i <=100; i ++) 
instead of 


i nt i ; 

for ( i =0; i <10; i + + ) 

The control variable may be initialized to any value, although it is almost al ways 0 or 1. 

The <update> expression in the example increments the control variable by 1. 
Wecan incrementitwith values other than 1, including negative values, forexample, 

for ( int i = 0; i < 100; i += 5) II i =0, 5, 10 . 95 

for ( i nt j = 2; j <40; j * = 2)/ /j =2, 4, 8, 16, 32 
for (int k = 100; k > 0; k-- ) //k = 1 0 0, 9 9, 9 8, 9 7 . 1 

Notice that the control variable appears in all three components: initializations 
conditional expressions and <update>. A control variabledoes nothaveto appear 
in all three components, but this is the most common style. M any other variations 
are allowed for these three components, but for novices, it is safer to use this style 
exclusively. 

Let's look at an example from physics. When an object is dropped from height 
H, the position P of the object at time t can be determined by the formula 

P = -16 1 2 + H 


For example, if a watermelon is dropped from the roof of a 256-ft-high dormitory, 
it will drop likethis: 


□ sy y 
n n y y 
□□□□ 


□□□□ 


cT3 * 


- 


256 ft at t = 0 
240 ft at r = 1 

192 ft at r = 2 


112 ft at r = 3 


0 ft at t = 4 
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Wecan use a for statement to compute the position Pat timer. Wewill input 
the initial height and compute the position every second. We repeat this computa¬ 
tion until the watermelon touches the ground. The time the watermelon touches the 
ground is derived by solving for t when P = 0. 


0 = -16 t 2 + H 



t = 



Chapter 6 Sample Program: Dropping a Watermelon 
File: Ch6DroppingWater Me Ion. java 


*/ 


import java,util.*; 

class Ch6Dropping Water Me Ion { 

public static void main( String!] args ) { 

double initialMeight, 
position, 
t o u c h T i me; 

Scanner scanner = new ScannerfSystem. in); 

System, out. print! "Initial Height:"); 
i n i t i a I He i g ht = s c a n ne r. ne x t Do u b I e () ; 

touchTime = Math. sqrt(i ni ti al Hei ght / 16.0); 

touchTime = Math. round(touchTi me * 10000.0) / 10000.0; 


//convert to four decimal places 


System, out. pri ntl n("\n\n Time t Position at Time t \n“); 


for ( i nt time = 0; time < touchTime; time+f) { 


position = -16.0 * t i me * t i me + initialHeight; 


System, out. pri n t ( " 
System, out. pri ntl n ( " 


em. out. pri nt(" " + t i me ) ; 


+ position); 


//print the last second 

System, out. pri ntl n(" " + t o u c h T i me + " 


0 . 00 "); 
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|i C:\WINDOWS\System32\cmd.eHe 

Initial 

He 

sight:500 

T ine 

t 

Position at Tine t 

0 


500.0 

1 


484.0 

2 


436.0 

3 


356.0 

4 


244.0 

5 


100.0 

5.5902 

0.00 


Figure 6.8 The positions of a watermelon dropped from a height of 500 ft. 


Running the program with the input value 500.0 for the initial height and using 
System. out as output will result in the window shown in Figure 6.8. 


Q\ou 

U Might 
Want to 

Know 



Java 5.0 introduces a new form of the for statement. There is no formal name for 
the newest for loop, but the name for-each loop is used most often.The for-each 
loop is a very convenient way to iterate over a collection of items. We will 
introduce the new for loop in Chapter 10 and see its use in the data structure 
chapters. 



The format for the for loop presented in this section is the most basic version. 
The Java language allows more complex for statements. For instance, the 
<initialization> and <update> parts of the for statement are not limited to a single 
statement. They can contain zero or more statements. The following two state¬ 
ments, for example, are both valid. 


i nt 
for 


} 


vaI, i , j 
= 0, j 
< 100 
++, j-- 
vaI += i 


= 100 
&& j > 
) { 


v a I 
50; 


= 0 ; 


III nit 
//bool expr 
II i n c r e me n t 


System, out. pri ntl n("val = " + val); 
Scanner scanner = new Scanner!System, in) 
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sum, c nt, n 

; 



( sum = 0, c 

nt = 

0; II 

i n i t 

c nt < 10; 


II 

bool expr 



II 

i n c r e me n t 

System, out. 

print 

("Enter 

n u mb e r: 

n = scanner 

. next 

1 nt ( ) , 



sum += n , 
c nt ++ ) { 


} 

Do you ever need to write such intricate for statements? Most likely, no.The two 
sample statements can be written more clearly and logically in other ways. We 
strongly recommend that you stick to the basic, and most logical, form of the for 
statement. 



We have introduced three forms of repetition statements— while, do-while, and 
for. They are equivalent in their expressive power. In other words, a loop written in 
one form of repetition statement can be written by using the other two forms of 
repetition statement. Although they are equivalent, in many cases one form would 
express the repetition control in a more natural and direct manner. It is your 
responsibility as a programmer to implement the repetition control using the 
most appropriate form. 



Quick 


CHECK 

V 


1. Write a for loop to compute the following. 

a. Sum of 1, 2.100 

b. Sum of 2, 4.500 

c. Product of 5, 10,..., 50 

2. Rewrite the foil owing while loops as for statements. 

a. i nt count =0, s u m = 0; 
while ( count < 10 ) { 

sum += count; 
count + + ; 

} 

b. i nt count = 1, s u m = 0; 
whi I e ( count <= 30 ) { 

sum += count; 
count += 3; 

} 
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6.6 


Nested for Statements 


In many processing tasks, we need to place a for statement inside another for state¬ 
ment. In this section, we introduce a simple nested for statement. We will see more 
examples of nested for statements later in the book, especially in Chapter 10 on 
array processing. 

Suppose we want to display a quick reference table for clerks at the Rugs-R- 
Us carpet store. The table in Figure 6.9 lists the prices of carpets ranging in size 
from 11 x 5 ft to 20 x 25 ft (using System.out for output). The width of a carpet 
ranges from 11 to 20 ft with an increment of 1 ft. The length of a carpet ranges 
from 5 to 25 ft with an increment of 5 ft. The unit price of a carpet is $19 per 
square foot. 

We use a nested for statement to print out the table. Let's concentrate first on 
printing out prices. We'll worry about printing out length and width values later. 
The following nested for statement will print out the prices: 


i nt 


price; 


outer 

for 


inner 

for 


for 


} 


( i nt width = 11; width <= 20; width ++) { 

for ( i nt length = 5; length <= 25; length += 5) 
price = width * length * 19; / / $ 19 per sq ft 
System, out. pri nt(" " + price); 

} 


//finished one row; now move on to the next row 
System, out. pri ntl n(""); 


{ 


L ength 


[sT 

C:\WINNT\System32\cmd. 

exe 




5 

10 

15 

20 

25 

11 

1045 

2090 

3135 

4180 

5225 

12 

1140 

2280 

3420 

4560 

5700 

13 

1235 

2470 

3705 

4940 

6175 

14 

1330 

2660 

3990 

5320 

6650 

15 

1425 

2850 

4275 

5700 

7125 

16 

1520 

3040 

4560 

6080 

7600 

17 

1615 

3230 

4845 

6460 

8075 

18 

1710 

3420 

5130 

6840 

8550 

19 

1805 

3610 

5415 

7220 

9025 

20 

1900 

3800 

5700 

7600 

9500 


Figure 6.9 The price table for carpets ranging in size from 11 X 5 ft to 20 X 25 ft whose unit price is $19 per 
square foot. 


www.it-ebooks.info 












6.6 Nested for Statements 333 


The outer for statement is set to range from the first row (width = 11 ) to the 
last row (width = 20 ). For each repetition of the outer for, the inner for statement is 
executed, which ranges from the first column (length = 5) to the fifth column 
(length = 25). The loop body of the inner for computes the price of a single carpet 
size and prints out this price. So the complete execution of the inner for, which 
causes its loop body to be executed 5 times, completes the output of one row. The 
following shows the sequence of values for the two control variables. 


width 

11 


12 


13 


length 


5 

10 

15 

20 

25 

5 

10 

15 

20 

25 

5 

10 


Completes the printing 
of the first row 


Completes the printing 
of the second row 


Now let's add the code to print out the row and column index values for width 
and length. 


int price; 


Added 

statements 


;'"TysTem. out . pri nt p . '5"T0""TT"'2 0""2 5' |T T;"' 

\ System, out. pri nt("\n\n"); 

for ( i nt width = 11; width <= 20; width+f) { 

System, out. pri nt ( wi d t h + " "); 


for ( int length = 5; length <= 25; length += 5) { 
price = width * length * 19; / / $ 19 per sq ft. 
System, out. pri nt( " " + p r i c e ) ; 


} 

//finished one row; now move on to the next row 
System, out. pri n t ( " \ n" ); 
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The next improvement is to include the labels width and Length in the output. 
This enhancement is left as Exercise 19 at the end of the chapter. Also, in the ex¬ 
ample, literal constants are used for the carpet sizes and the increment value on 
length (n, 20, 5, 25, and 5), but in a real program, named constants should be used. 


r— ■ 

Quick 

CHECK 


1. What will be the value of sum after the following nested for loops are 
executed? 

a. i nt sum = 0; 

for ( i nt i = 0; i < 5; iff) { 

sum = sum + i ; 

f or ( i nt j =0; j <5; j + + ) { 

sum = sum + j; 

} 

} 

b. i nt s u m = 0; 

for ( i nt i =0; i <5; iff) { 

sum = sum + i ; 

for ( int j = i; j <5; j ++) { 

sum = sum + j ; 

} 

} 

2. What is wrong with the following nested for loop? 

i nt sum = 0; 

for ( i nt i = 0; i < 5; iff) { 
sum = sum + i ; 

for (int i = 5; i >0; i - - ) { 

sum = sum + j; 

} 

} 


6.7 


Formatting Output 


In the table shown in Figure 6.10, the values are aligned very nicely. We purposely 
selected the unit price and the ranges of width and length so that the table output 
would look good. Notice that the output values are all four-digit numbers. Realisti¬ 
cally, we cannot expect output values to be so uniform. Let's change the unit price 
to $15 and the range of widths to 5 through 14 ft and see what happens. The result 
is shown in Figure 6.10, which is not as neat as the previous output. What we need 
is a way to format the output so the val ues are pri nted out with the proper al ignment. 

In the code, we used the fixed number of spaces between the values, and it 
worked because the output values have the same number of digits. To align the val¬ 
ues with a varying number of digits, we must vary the number of spaces in front of 
the values, as shown in Figure 6.11. 

The basic idea of formatted output is to allocate the same amount of space for 
the output values and align the values within the allocated space. We call the space 
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C:\WINDOWS\System32\cmd.exe 



5 

10 

15 

20 

25 

5 

375 

750 

1125 

1500 

1875 

6 

450 

900 

1350 

1800 

2250 

7 

525 

1050 

1575 

2100 

2625 

8 

600 

1200 

1800 

2400 

3000 

9 

675 

1350 

2025 

2700 

3375 

10 

750 

1500 

2250 

3000 

3750 

11 

825 

1650 

2475 

3300 

4125 

12 

900 

1800 

2700 

3600 

4500 

13 

975 

1950 

2925 

3900 

4875 

14 

1050 

2100 

1 3150 

l 4200 

l 5250 


Figure 6.10 The price table for carpets with $15 per square foot and width ranging from 5 through 14 ft. 


--3 

-34 

--5684 

-98 

---231 

445 

---339 

---234 

---453 

--3444 


Each value occupies six spaces. If 
the value has three digits, we put 
three blank spaces in front. If the 
value has four digits, we put two 
blank spaces in front, and so forth. 


Figure 6.11 How to place a varying number of spaces to align the output values. Hyphen is used here to 
indicate the blank space. 


field occupied by an output value the field and the number of characters allocated to a 

field its field width. In Figure 6.11, the field width is 6. 

We have already used two formatting classes— DecimalFormat and Simple- 
DateFormat— introduced in Chapters 2 and 3. The most recent version of Java SDK 
1.5 has a new general-purpose formatting class called Formatter that includes the 
functionalities of DecimalFormat and simpleDateFormat. For its power, using the 
Formatter class is slightly more complicated than using the DecimalFormat and 
SimpleDateFormat classes. 

To format output using Formatter, first we create its instance by passing the 
destination of the output as an argument. Suppose we want to send the formatted 
output to System.out; then we create a Formatter object as follows: 

Formatter formatter = new FormatterfSystem. out); 

Next we call its format method to output the formatted values. For example, to out¬ 
put an integer with the field width of 6, we write 

int num = 4 6 7; 

f o r ma 11 e r. f o r ma t ( " %6 d" , n u m) ; 
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control string 


Figure 6.12 


The string %6d is called a control string, and it directs how the formatting will take 
place. The value 6 sped ties the field width, and the control characterd indicates the 
output value is a decimal integer. 

The general syntax for the format method is as follows: 

format! <control s t r i n g >, <e x p r 1 >, < e x p r 2 > , ..,) 

The first argument is the control string, and it is followed by zero or more expres¬ 
sions. The control string may include the actual output string in addition to control 
values. For example, the statement 

i nt n uml , n um2 , n um3; 

nil ml = 34; 
nil m2 = 9; 

n u m3 = n u ml + n u m2; 

f o r ma 11 e r. f o r ma t ( " %3 d + %3 d = %5 d " , n u ml, n u m2, n u m3 ) ; 

will output 


34 + 9 = 43 


Figure 6.12 shows how the control values are matched left to right against the 
arguments. The figure also illustrates how the noncontrol values (such as + and = 
symbols) are output to the destination. 

We can change the default left-to-right argument matching by including the 
argument index in the control string. The arguments can be indexed as i$, 2$, and 
so forth. For example, the output of 

f o r ma 11 e r. f o r ma t ( " %3 $ 3 d is the s u m o f %2 $ 3 d and %1 $ 3 d " , 

n u ml, n u m2, n u m3 ); 


will be 


43 is the s urn of 9 and 34 



The control values are matched left to right. 
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To format real numbers, we include the number of decimal places along with 
the field width in the fol lowing format: 

%<field wi dt h> . <deci maI pi aces > f 

The control letter f designates formatting a floating-point number. Here'san exam¬ 
ple to format 345.9867 using a field of width 15 and two decimal places: 

f o r ma 11 e r. f o r ma t ( " %15. 3 f" , 3 4 5.9 8 6 7 ); 

To format a string, we use the control letters. Here'san example: 

String n a me = "John"; 

formatter. format("Hel I o, %s. Nice to meet you.", n a me ) ; 

The output will be 


Hello, John. Nice to meet you, 

We can also use the format method to format the date information. We use the 
control I etter t for formatti ng an i nstance of GregorianCalendar or Date. T he control 
letter t must be followed by another control letter that designates the formatting of 
the components of the date information, such as month, day, or year. For example, 
if we write 

GregorianCalendar day = new Gregori anCal endar ( 1776, 6, 4); 
f o r ma 11 e r. f o r ma t ( " %1 $ t B %1 $ t e, %1 $ t Y " , day); 

the output will be 


July 4, 1776 

The date control letter B designates the full month name, e designates the day in two 
digits, and Y designates the year in four digits. For other data control letters, please 
consult the documentation. Notice that there is only one output argument, and it is 
referred to as i$ three times in the control string. 

The use of the Formatter class gives us the most control over the formatting, 
but for common output formatting, we can do it by using the format method of 
System.out or the string cl ass i nstead. (I n thi s secti on, we presented onl y a subset of 
common formatting.) For example, the following code 

System, out. f o r ma t ( " %5 s is %3 d years old", "Bill", 20); 

is equivalent to 

Formatter formatter = new FormatterJSystem. out); 
f o r ma 11 e r. f o r ma t ( " %5 s is %3d years old", "Bill", 20); 
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FC C:\WINDOWS\System32\cmd.exe 



5 

10 

15 

20 

25 

5 

37S 

750 

1125 

1500 

1875 

6 

450 

900 

1350 

1800 

2250 

7 

525 

1050 

1575 

2100 

2625 

8 

600 

1200 

1800 

2400 

3000 

9 

675 

1350 

2025 

2700 

3375 

10 

750 

1500 

2250 

3000 

3750 

11 

825 

1650 

2475 

3300 

4125 

12 

900 

1800 

2700 

3600 

4500 

13 

975 

1950 

2925 

3900 

4875 

14 

1050 

2100 

3150 

4200 

5250 


Figure 6.13 Carpet price table of Figure 6.11 with proper alignment. 


(Note: Forthose who are familiar with C orC++, there's a method named printf de¬ 
fined for System.out that works exactly the same as the format method. However, 
Java's printf is similar but not identical to the one in C or C++.) 

Instead of printing out, it is possible to create a formatted string and assign it 
to a variable with the format method of the string class. Here's an example: 

St ring out put St r 

= S t r i n g. f o r ma t (" %3 d + %3 d = %5 d" , n u ml, n u m2, n u m3 ) ; 

We close the section with a program that produces the carpet price table with 
proper alignment for the range of values used in producing the table in Figure 6.10. 
Running this program will produce the table shown in Figure 6.13. 



Chapter 6 Sample Program: Sample formatting statements 


Fi le: Ch6CarpetPri ceTabl eWi thFormat.j ava 


*1 

class Ch6CarpetPri ceTabl eWi thFormat { 

public static void main (Stri ng [ 1 ar gs ) { 
i nt price; 

//print out the column labels 

System, out. print!" "); //put three blank spaces first 

for ( i nt col Label = 5; col Label <=25; col Label += 5) { 
System, out. format! " %8 d " , col Label ) ; 

} 
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System, out. p r i n 11 n ( ""); 

System, out. p r i n 11 n ( ""); 

//print out rows of prices 

for ( i nt width = 5; width <= 14; wi d t h + +) { 

System, out. f o r ma t ( " %3 d" , width); 

for ( i nt length = 5; length <= 25; length += 5) { 
price = width * length * 15; 

System, out. f o r ma t ( " %8 d " , price); 

} 

//finished one row; now move on to the next row 
System, out. pri ntl n(""); 


System, out. pri ntl n ( "" ); 
System, out. pri ntl n ( "" ); 

} 

} 


P— 

Quick 

°T 


1. Determine the output of the following code. 

System, out. f o r ma t ( " %3 d + %3 d = %3 d, 1, 2, 3 ) ; 

System, out. f o r ma t ( " %t Y" , new D a t e ( )) ; 

System, out. f o r ma t ( " %2 $ s , %1 $ s, “John", " S mi t h" ) ; 

2. What’s wrong with the following code? 

Formatter f = new Formatter) ); 
f . f o r ma t ( " %8. 3 f " , 2 3 2.5 6 3 ); 


6.8 Loan Tables 

The LoanCalculator program computed the monthly and total payments for a given 
loan amount, annual interest rate, and loan period. To see the monthly payment for 
the same loan amount and loan period but with a different interest rate, we need to 
repeat the calculation, entering the three values again. To illustrate the use of the 
concepts introduced in this chapter, let's design a program that generates a loan 
table (similar to the carpet price table) for a given loan amount so we can compare 
different monthly payments easily and quickly. The columns of the table are the 
loan periods in number of years (5, 10, 15, 20, 25, 30), and the rows are interest 
rates ranging from 6 to 10 percent in increments of 0.25. 
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pseudocode 


In this section, we provide a discussion of the relevant methods only. Let's 
begin with a design of the topmost start method of the top-level controller class. 
The start method can be expressed as 

tell the user what the program does; 

prompt the user "Do you want to generate a loan table?"; 

while (the user says YES) { 

input the loan amount; 

generate the loan table; 

prompt the user "Do you want another loan table?"; 

} 

The start method is expressed in pseudocode. Pseudocode is an informal language 
we often use to express an algorithm. Pseudocode is useful in expressing an algo¬ 
rithm without being tied down to the rigid syntactic rules of a programming lan¬ 
guage. We can express a simple algorithm in the actual programming language 
statements, but for a more complex algorithm, especially those involving nonse¬ 
quential control flow logic, pseudocode is very helpful in expressing the algorithm 
concisely and clearly. Whenever appropriate, we will use pseudocode to express 
more complex algorithms in the remainder of the book. 

T ransl ati ng the pseudocode i nto J ava code w i 11 resul t i n 

private static enum Response {YES, NO} 

public void start! ) { 

Response response; 
descri beProgram( ) ; 

response = prompt! "Generate a loan table?"); 

while (response == Response.YES ) { 

I o a n A mount = get LoanAmount!); II get input 
generateLoanTabl e( I oanAmount ) ; //generate table 

response = pro mpt( "Generate another loan table? 11 ); 

} 

} 

private Response prompt(String question) { 

String input; 

Response response = Response.NO; 

System, out. pri nt(questi on + " (Yes - y; No - n): "); 

input = scanner, next!); - scanner is created in a 

constructor 
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if (i nput.equal s("Y") | | i nput. equal s("y")) { 
response = Response. YES; 

} 

return response; 

} 

Notice how the actual start method is almost as easy to read as the pseudocode. By 
using objects and well-designed (sub)methods, we can express methods that are as 
easy to read as pseudocode. 

The describeProgram method tells the user what the program does if the user 
requests it. The getLoanAmount method gets the loan amount from the user. The 
method will allow the user to enter the loan amount between loo.oand 500000.0. The 
generateLoanTable method generates the loan table, which we explain in detail next. 

We use a nested loop to generate the table. Both the inner and outer loops are 
count-controlled loops. The loop for columns (years) will range from 5 to 30 with 
an increment of 5 and the loop for rows (rates) will range from 6.0 to 10.0 with an 
increment of 0.25. So the nested loop can be written as follows: 

private static final int BEGI NYEAR = 5; 

private static final int END_YEAR = 30; 

private static final int YEARI NCR = 5; 

private static final double BEGI N_RATE = 6,0; 

private static final double END_RATE = 10.0; 

private static final double RATE! NCR = 0.25; 


for (double rate = BEGIN RATE; rate <= END RATE; 

rate’ += RATE_I NCR) { 

for (int year = BEGIN YEAR; year <= END YEAR; 

year’ += YEARJ NCR) { 


//compute and display the monthly loan payment 
//for a given year and rate 

} 

} 

Notice the outer loop is using double as the loop counter, something we dis¬ 
couraged in Section 6.2. In this particular case, with the increment value of 0.25, 
there will be no problem because this value can be represented precisely in com¬ 
puter memory. M oreover, the terminating condition rate <= end_rate guarantees 
that the loop will terminate eventually if we keep adding ratejncr to rate. 

To compute the monthly loan payment, we simply reuse the Loan class we 
defined in Chapter 4 as follows: 

double amount = ; 

double rate =,,. ; 
int period =... ; 
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Loan loan = new Loan( ); 
double monthlyPayment 

= loan, get MonthlyPaymen t ( a mount, rate, period); 

This is the power of object-oriented programming. Because a single well- 
defined task of loan computation and nothing else is coded in the Loan class, we are 
able to reuse it here easily. What would happen had we not designed the Loan class? 
It was certainly possible for us to complete the Chapter 4 sample development pro¬ 
gram with one service class that handles everything: input, output, and computation 
tasks. The chance of reusing such a class, however, is very low. J ust as we do not 
expect to buy a textbook that teaches all five subject matters of single-variable cal¬ 
culus, introduction to economics, organic chemistry, introduction to programming, 
and western civilization, we do not want a service class that is overloaded with 
many different types of tasks. We do not want one class that does everything. 
Rather, we want many classes, with each class doing one task effectively and effi¬ 
ciently. This will allow us to mix and match the classes easily. 

Finally, the output values can be formatted by using the technique introduced 
in Section 6.7. Overall design is now complete. It is left as an exercise (Exercise 17) 
to implement the loan table calculation program. 


6.9 


Estimating the Execution Time 


We promised at the end of Section 6.1 to compare the two versions of gcd methods 
experimentally. Detailed analysis of algorithms is beyond the scope of this book 
(we providea little bit of analytical comparisons of sorting algorithms in this book), 
but experimental analysis is within our realm. We can compare the performance of 
different methods by actually running them and clocking their execution times. 

Here's the basic idea: 


Start the clock (stopwatch) 

Run the method 
Stop the clock 
Report the elapsed time 

There is no clock or stopwatch standard class, but we can time the execution 
by using the Date class from the java.util package. Before we call the method we 
want to time, we record the start time by creating a Date object. After the method is 
completed, we record the end time by creating a second Date object. Calling the 
getTime method of the Date class returns the number of milliseconds (1 ms = 
1/1000 s) sincej anuary 1,1970 00:00:00 Greenwich M ean Time. So by subtracting 
the start time from the end time, we can get the elapsed time in milliseconds. Here's 
the general idea: 

Date s t a r t T i me = new Da t e () ; 

II the method call comes here 
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Dat e endTi me = new Dat e ( ) ; 

long elapsedTi me In Milliseconds = 

endTi me.getTi me() - startTi me.getTi me(); 

Now let's write a short program to time the performance of gcd and 
gcd_bruteforce. The program includes many of the techniques discussed in this 
chapter. Here's the program (we do not repeat the method bodies of gcd and 
gcd_bruteforce here): 


Chapter 6 Sample Program: Time the performance of gcd methods 
File: Ch6Ti meGcd.j ava 

*/ 

import java,util.*; 
class Ch6Ti meGcd { 

private static enum ComputationType { BRUTE_FORCE, EUCLID} 

private Scanner scanner; 

public static void main(String[] args) { 

Ch6Ti meGcd tester = new Ch6TimeGcd( ); 
t es t er.s t a r t () ; 

System, exit(O); 

} 

public C h 6 T i meGc d( ) { 

scanner = new Scanner ( Syst em. in); 

} 

public void start) ) { 

long bruteForceTi me, e u c I i d T i me; 
i n t m, n; 

whi I e (i sConti nue()) { 

m = getPositivelnteger( ); 
n = getPositivel nteger( ); 

//Time the brute force method 

bruteForceTi me = t i meMet hod( m, n, Computati onType, BRUTE_FORCE); 

//Time the Euclidean method 

euclidTime = t i meMet hod( m, n, ComputationType.EUCLID); 
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System, out. pri ntl n("M: " + m) ; 

System, out. pri ntl n("N: " + n); 

System, out. pri ntl n("Brute Force Time: " + bruteForceTi me); 

System, out. pri ntl n(" Euclidean Time: " + e u c I i d T i me + "\n") 

} 

} 

private long ti meMethod(i nt m, int n, Computati onType type) { 

Date s t a r t T i me, e n d T i me; 
startTime = new D a t e ( ) ; 

if (type == Computati onType. BRUTE_FORCE) { 
gcd_bruteforce(m, n); 

} else { 

gcd( m, n) ; 

} 

endTime = new Dat e ( ) ; 

return (endTi me. getTi me() - startTi me. getTi me()); 


private int getPo s i ti ve I n teger ( ) { 
int input; 

whiIe (true) { 

System, out, print) “Enter positive integer (0 is okay):' 1 ); 
input = scanner. nextlnt(); 

if (input >= 0) break; 

System, out. pri ntl n(" Input must be 0 or mo re"); 

} 

return input; 


private boolean i sConti nue( ) { 

String input; 

boolean response = false; 

System, out. print) "Run test? "); 
input = scanner. next(); 

if ( i n p u t.e q u a I s (" Y" ) || i nput. equal s("y")) { 
response = true; 

} 
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return response; 

} 

private int gcd_bruteforce(i nt m, int n) { 

} 

private int gcd(int m, int n) { 

} 


Here's a sample interaction: 


Run test? y 

Enter positive integer (0 is okay):4567820 

Enter positive integer (0 is okay) : 2 1 4 7 4 8 3 6 4 0 

M: 4567820 

N: 2147483640 

Brute Force Time: 94 

Euclidean Time: 0 


Run test? y 

Enter positive integer (0 is okay): 1 4 5 7 6 8 9 0 9 8 

Enter positive integer (0 is okay) : 2 1 4 7 4 8 3 6 4 0 

M: 1457689098 

N: 2147483640 

Brute Force Time: 31953 

Euclidean Time: 0 


Run test? n 


The value of o for Euclidean time does not imply that it took no time to com¬ 
pute the result. It means that the time it took was so miniscule, we weren't able to 
detect it by the techni que we used. N otice that, for the brute-force approach, the dif¬ 
ference in the running times between thesmalI and Iarge valuesfor M is substantial, 
while the difference for the Euclidean approach is not discernible. Detailed analysis 
will actually tell us that the running time for the brute-force approach is linearly 
proportional to the input size M , while the Euclidean approach is logarithmically 
proportional to the input size M . So, for the second comparison in the sample run, 
there will be 1,457,689,098 divisions performed (actually twice this number 
because we are executing m % i == o && n % i == o) in gcd_bruteforce, but only log 
1,457,689,098 = 9 divisions. See how superior the Euclidean approach is? 
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recursive 

method 


K eep i n mi nd that the val ue we get for the el apsed ti me i s a rough esti mate. F or 
one thing, the values we get for the elapsed time differ dramatically according to 
which CPU we run the program on and whether other processes are running at the 
same time (e.g., if a garbage collection routine kicks in while a method is running, 
then the runtime esti mate can be way off). Also, the granularity is very coarse when 
timed from a high-level language such as Java. For example, it is not possible to dis¬ 
tinguish between the program that runs in 5 ms and the program that runs in 6 ms. 
AI though the val ue i s a rough esti mate, i t sti 11 gi ve us useful i nformati on such as the 
rate of increase in execution time as we increase the size of input values. 




ings to Remember 

To estimate the running time of a loop statement: 

1. Record the start time by creating a Date object, say, startTime, before the loop 
statement. 

2. Record the end time by creating another Date object, say, endTime, after the 
loop statement. 

3. Elapsed time (in milliseconds) is computed as follows: 

el apsedTi me = endTi me. getTi me( ) 

- s t a r t T i me. g e t T i me ( ) ; 


6.10 Recursive Methods ( Optional) 

In addition to the three repetition control statements we introduced in this chapter, 
there is a fourth way to control the repetition flow of a program by using recursive 
methods. A recursive method is a method that contains a statement (or statements) 
that makes a call to itself. We explain recursive methods briefly in this section. 
Realistic examples of recursive methods will be given in Chapter 15. 

So far, we have seen only methods that cal I other methods, something I ike this: 

me t h o d 0 n e (, . . ) { 

methodTwo( . . . ) ; //method One called met hodTwo 

} 

met hodTwo (. . . ) { 

} 

A recursive method calls itself, and it looks something like this: 

me t h o d 0 n e (. . . ) { 
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method One (...); II calls the method itself 

} 

At first glance, it seems as if a recursive cal I will never end si nee the cal I is made to 
the same method. Indeed, if you do not follow the rules, you could end up with 
infinite recursive calls. In this section we explain how to write recursive methods 
correctly. 

Suppose we want to compute the factorial of N. The factorial of N isthe prod¬ 
uct of the first N positive integers, denoted mathematically as 

N! = N* (N-l) * (N-2) * ■■■ * 2* 1 

We will write a recursive method to compute the factorial of N. M athemati- 
cally, we can define the factorial of N recursively as 

' 1 i f N = 1 

factori al (N) = • 


. N * factorial (N-l) otherwise 


The definition states that if N is 1, then the function factorial(N) has the 
value i. Otherwise, the function factorial(N) is the product of N and factorials -i). 
For example, the function factorial^) is evaluated as follows: 


factorial (4) 
24 C I 


c 




factorial (3) 

I 

3 * factorial(2) 

c * 


factori al(l) 


1 


The recursive factorial method parallels the preceding mathematical defini¬ 
tion. The method is defined thus: 


//Assnme N is greater than 0 

public int factori al(i nt N) { 

if ( N == 1) Test to stop or continue. 


} 


return 1; 
else 

return N * 


End case: recursion stops. 


factorial (N-l); 


Recursive case: 

recursion continues with 
another recursive call. 
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The diagram in Figure 6.14 illustrates the sequence of calls for the recursive 
factorial method. Recursive methods will contain three necessary components. 


L^jings to Remember 

The three necessary components in a recursive method are 

1. A test to stop or continue the recursion. 

2. An end case that terminates the recursion. 

3. A recursive call(s) that continues the recursion. 



To ensure that the recursion will stop eventually, we must pass arguments different 
from the incoming parameters. In the factorial method, the incoming parameter was 
N, while the argument passed in the recursive cal I was N— i. This difference of i be¬ 
tween the incoming parameter and the argument will eventually make the argument 
in a recursive call be i, and the recursion will stop. 

Let's implement two more mathematical functions using recursion. The next 
method computes the sum of the first N positive integers 1 , 2 ,..., N. Notice how this 
method includes the three necessary components of a recursive method. 

public int sum ( int N ) { //assume N >= 1 
if ( N == 1) 
return 1; 
else 

return N + sum( N- 1 ); 

} 

The last method computes the exponentiation a n , where A is a real number 
and N is a positive integer. This time, we have to pass two arguments— A and N. 
The value of A will not change in the calls, but the value of N is decremented after 
each recursive call. 

public double exponent ( double A, int N ) { 
if ( N == 1) 
return A; 
else 

return A * exponent! A, N-l ); 

} 

So far we used only mathematical functions to illustrate recursive methods, 
but recursion is not limited to mathematical functions. Let's look at one example. 
We know the length method of the string class returns the number characters in a 
given string. Let's write a recursive method that does the same thing. Here's how we 
think recursively. The total number of characters in a string is 1 plus the number of 
characters in the substring from the second position to the end of the string. If the 
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24 



Figure 6.14 The sequence of calls for the recursive factorial method. 
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string has no characters, then the length is zero. Puting this idea into an actual 
method, we have 

public int I engt h( St r i ng st r ) { 

if (str. equal s("")) { II s t r has no characters 

return 0; Index of the second 

position is 1. 

} else { 

return 1 + I engt h( str.substri ng( 1) ) ; 

} 

} 

We will present more examples of recursive methods that implement nonnu- 
merical operations in Chapter 15. 

We used factorial, sum, exponentiation, and length as examples to introduce 
some of the basic concepts of recursion, but we should never actually write these 
methods using recursion. The methods can be written more efficiently in an itera¬ 
tive (i.e., nonrecursive) manner using a simple for loop. In practice, we use recur¬ 
sion if certain conditions are met. 


iThings to Remember 



Use recursion if 

1. A recursive solution is natural and easy to understand. 

2. A recursive solution does not result in excessive duplicate computation. 

3. The equivalent iterative solution is too complex. 


As a final review of the topic, we conclude this section with the recursive 
version of the Euclidean gcd method. Remember the logic behind the Euclidean 
gcd method is a sequence of reducing the problem, for example, gcd(48, 16) = 
gcd(i6, 12 ) = gcd(i2, 4) = 4. Here's how we can express this thinking recursively: 

public int gcd_recursi ve( i nt m, int n) { 

int result: 

if ( m == 0) {//test 

result = n; //end case 

} else { 

result = gcd_recursi ve( n % m, m); //recursive case 

} 

return result; 
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6.11 Sample Development 


Hi-Lo Game 

In this section we will develop a program that plays a Hi-Lo game. This program illustrates 
the use of repetition control, the random number generator, and the testing strategy. The 
objective of the game is to guess a secret number between 1 and 100. The program will 
respond with HI if the guess is higher than the secret number and LO if the guess is lower 
than the secret number. The maximum number of guesses allowed is six. If we allow up to 
seven, one can always guess the secret number. Do you know why? 


Problem Statement 

Write an application that will play Hi-Lo games with the user. The objective of the 
game is for the user to guess the computer-generated secret number in the least 
number of tries. The secret number is an integer between 1 and 100, inclusive. 
When the user makes a guess, the program replies with HI or LO depending on 
whether the guess is higher or lower than the secret number. The maximum 
number of tries allowed for each game is six. The user can play as many games as 
she wants. 


program 

tasks 


Overall Plan 

We will begin with our overall plan for the development. Let's identify the major tasks of 
the program. The first task is to generate a secret number every time the game is played, 
and the second task is to play the game itself. We also need to add a loop to repeat these 
two tasks every time the user wants to play the Hi-Lo game. We can express this program 
logic in pseudocode as follows: 

do { 

Task 1: generate a secret number; 

Task 2: play one game; 

} while ( the user wants to play ); 

Let's look at the two tasks and determine objects that will be responsible for 
handling the tasks. For the first task, we will use the random method of the Math class. 
We will examine this method in detail later to determine whether it is the one we can use 
in the program. If this method does not meet our needs, then we will explore further and 
most likely will have to derive our own random number generator. 

For the second task of playing the game itself, we use objects that handle I/O and 
the logic of repeatedly asking for the next guess until the game is over. For input and 
output, we use a Scanner and System.out. We will define a class to handle the logic of 
playing the game. This class will control the other two classes. We will name this class 
Ch6HiLo, and it will be an instantiable main class. 
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6.11 Sample Development— continued 


Here's our working design document: 


Design Document: C h 6 H i Lo 

Class 

Purpose 

Ch6Hi Lo 

The top-level control object handles the logic of 


playing games and manages other objects. This is 


the instantiable main class. 

Scanner 

This standard class is for inputting user guesses. 

Pr i nt St r ea m 

This standard class is for displaying hints and other 

( Syst em. out ) 

messages. 


develop¬ 
ment steps 


Figure 6.15 is the program diagram for this program. A keen observer may have noticed 
that the Ch6HiLo class is handling both types of tasks: handling of user interface and con¬ 
trolling the logic of game playing. We will revisit this design in the GUI chapter and 
provide an alternative.The one-class design we adopt here may not be an ideal design, 
but may be acceptable for a simplistic game such as this one.The design also provides 
us with a meaningful comparison when we present an alternative design in the GUI 
chapter. 

We will implement this program using the following four major steps: 

1 . Start with a skeleton Ch6HiLo class. 

2. Add code to the Ch6HiLo class to play a game using a dummy secret number. 

3. Add code to the Ch6HiLo class to generate a random number. 

4. Finalize the code by removing temporary statements and tying up loose ends. 


Step 1 Development: Program Skeleton 

step 1 The structure of the HiLoMain class is the same as other main classes. All we need to do is 

design to declare, create, and start a HiLo object. Instead of forcing the user to play at least one 


Scanner 


C h6HiL o 


PrintStream 




N 

(System.out) 




— 



Figure 6.15 The program diagram for the HiLo program. 
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game, we will implement the program so the user has an option of not playing a game 
at all. In pseudocode we can express this logic as follows: 


describe the game r ul 

prompt the user 

to pi 

while ( answer i 

s yes 

generate the 

seer e 

play one game 

: 

prompt the us 

er to 


} 


es ; 

ay a game or not; 

) { 

t number ; 

play another game or 


not ; 


Notice that we use a while loop here, so the user can quit the program without 
playing a game. If we use a do-while loop instead, then the user must play at least one 
game before stopping the program. We opt to use the while loop because the user may 
not want to play the game at all after reading the game rules. 

We use a private method describeRules to display the game rules. Another private 
method named prompt gets a yes/no reply from the user. We call this method to ask if 
the user wants to play a game. To generate a secret number, we have the third private 
method generateSecretNumber. Lastly, we define the fourth private method playGame 
to play one game. We declare these four methods private because these methods are for 
internal use. As always, we will use the constructor to perform necessary object creation 
and initialization. 

Our working design document for the HiLo class is as follows: 


Design Document:The Ch 6 Hi Lo Class 

Method 

Visibility 

Purpose 

<constructor> 

public 

Creates and initializes the objects 
used by a Hi Lo object. 

start 

public 

Starts the Hi-Lo game playing.The 
user has an option of playing a game 
or not. 

descri beRu1 es 

pri vat e 

Displays the game rules in 

Syst em, out. 

generateSecretNumber 

pri vat e 

Generates a secret number for the 
next Hi-Lo game. 

pi ay Game 

pri vat e 

Plays one Hi-Lo game. 

p r o mp t 

pri vat e 

Prompts the user for a yes/no reply. 
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6.11 Sample Development— continued 


step 1 code 


For the skeleton program, we include temporary output statements in the private 
methods to verify that they are called correctly in the right order. Here's the skeleton 
Ch6HiLo class: 


import java,util.*; 

/ * 

Chapter 6 Sample Development: Hi - Lo Game (Step 1) 
The instantlable main class of the program. 


class C h6 H i Lo { 

private static enum Response {YES, NO} 
private Scanner scanner; 

//Mai n Method 

public static void main (String!] args) { 
Ch 6Hi Lo hi Lo = new Ch6 Hi Lo ( ) ; 
hi Lo. s t a r t () ; 

} 

public Ch6Hi Lo ( ) { 

scanner = new Scanner! Syst em. in); 


public void start! ) { 

Response a ns we r; 

descri beRul es( ) ; 

answer = prompt! “Do you want to play a Hi-Lo game?"); 

while (answer == Response. YE S ) { 

gener at eSecret Number ( ); 

pi ay Game! ); 

answer = prompt! "Do you want to play another Hi-Lo game?"); 

} 

System, out. println!" Thank you for playing Hi-Lo."); 


( - — 

main 


r 

Constructor 



/ 




start 






] 
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} 



step 1 test 
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private void descri beRul es( ) { 


describeRules 


} 


System, out. print Inf" Inside describeRules"); II TEMP 


private void generat eSecret Number ( ) { 


generateSecretNumber 


} 


System, out. print Inf" Inside generateSecretNumber"); //TEMP 


playGame 


private void playGame) ) { 

System, out. pri ntl n("l nsi de playGame 11 ); //TEMP 

} 

private Response prompt(String question) { 

String input; 

Response response = Response,NO; 

System, out. pri nt(questi on + “ (Yes - y; No - n): "); 
input = scanner, n ext ( ) ; 

if (i nput.equal s("Y") || i nput. equal s("y")) { 
response = Response,YES; 

} 


prompt 


return response; 


We execute the skeleton Ch6HiLo class to verify that the class is coded correctly. To 
verify the correct execution of step 1, we attempt to play the game 

1. Zero times 

2. Onetime 

3. One or more times 

For the first run, we select No to the prompt Do you want to play a Hi-Lo game? 
and make sure the program stops without playing a game. For the second run, we select 
Yes to the first prompt and verify that the messages Inside generateSecretNumber and 
Inside playGame are shown in the console window. We select No to the prompt Do you 
want to play another Hi-Lo game? and make sure the program stops. For the third run, 
we make sure we can play more than one game. After we verify all the scenarios work 
correctly, we proceed to the next step. 
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6.11 Sample Development— continued 


Step 2 Development: Play a Game with a Dummy Secret Number 

step 2 In the second development step, we add a routine that plays a Hi-Lo game. Let's begin 

design with the control flow of the playGame method. There are two cases to end a Hi-Lo 

game: The user either guesses the number in less than six tries or uses up all six tries 
without guessing the number. So we need a counter to keep track of the number of 
guesses made. Let's call this counter guessCount. We stop the game when guessCount 
becomes larger than 6 or the user's guess is equal to the secret number. At the end 
of the game, we output an appropriate message. Expressing this in pseudocode, we 
have 


//Method: pi ayGame 
set guessCount to 0; 

do { 

get next guess; 

increment guessCount; 

if (guess < secret Number ) { 
print the hint LO; 

} else if (guess > secretNumber) { 
print the hint HI; 

} 

} while (guessCount < number of guesses allowed && 

guess != secretNumber ); 

if (guess == secretNumber) { 
print the winning message; 

} else { 

print the losing message; 

} 

All variables used in this method will be local except secretNumber, which will be an in¬ 
stance variable. The value for secretNumber is set inside the generateSecretNumber 
method. 

To support a better user interface, we will include an input error handling that allows 
the user to enter only values between 1 and 100. We will do this input-error-checking rou¬ 
tine in a new private method getNextGuess because we do want to keep the playGame 
method clean and simple. If we included the code for input error handling directly inside 
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step 2 code 


the playGame method, the method would become too cluttered and lose the overall clar¬ 
ity of what the method is doing. Pseudocode for the getNextGuess method is 


//Method: getNextGuess 

whiIe ( true ) { 

get input value; 

if ( valid input ) return input 
print error message; 


v al ue; 


The working design document of the class now includes this new private method: 


Design Document: The Ch 6 Hi L o Class 

Method 

Visibility 

Purpose 

getNextGuess 

private 

Returns the next guess from the user. Only 
accepts a guess between 1 and 100. Prints 
an appropriate error message when an 
invalid guess is entered. 


In the step 2 coding, we need to implement three methods. In addition to 
the playGame and getNextGuess methods, we need to define a temporary gen- 
erateSecretNumber method so we can test the playGame method. The temporary 
generateSecretNumber method assigns a dummy secret number to the instance vari¬ 
able secretNumber. The temporary method is coded as follows: 

private void generateSecretNumber! ) { 
secretNumber =45; //TEMP 

} 


Any number will do; we simply picked the number 45. Knowing that the secret number is 
45, we will be able to test whether the playGame method is implemented correctly. 

We implement the playGame method thus: 

private void playGame! ) { 
int guess Count = 0; 
i nt guess; 

do { 

II get the next guess 

guess = getNextGuess!); 

new private method. 

guessCount ++; 
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6.11 Sample Development— continued 


Repeat the loop if 
the number of tries 
is not used up and 
the correct guess is 
not made. 


//check the guess 

if (guess < secretNumber) { 

System, out. println 

"Your guess is L0" ); 


} else if (guess > secretNumber) { 

System, out.println 

"Your guess is 

} 

} while ( guessCount < MAX_GUESS_ALLOWED && 
guess ! = secretNumber ) ; 


//output appropriate message 

if ( guess == secretNumber ) { 

System, out. pri ntl n 

“You guessed it in " 

+ guessCount + " tries.") 

} else { 

System, out. pri ntl n 

"You lost. Secret No. was 
+ secretNumber); 

} 


This class constant 
is set to 6. 


The getNextGuess method will accept an integer between 1 and 100. The method 
uses a while loop to accomplish this: 

private i nt getNextGuess) ) { 
i nt input; 

whiIe (true) { 

System, out. pri nt( "Next Guess: " ); 
input = scanner, n ex11 nt () ; 

if ( L OWE R _ BOUND <= input && input <= UP P E R_ BOUN D) { 
return input; 

} 

//invalid input; print error message 
System, out. println( “Invalid Input: " + 

"Must be between " + LOWER_BOUND + 

11 and " + UPPER BOUND); 

} 

} 
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step 2 test 


test cases 


step 3 
design 


The necessary constant and instance variable are declared in the data member sec¬ 
tion of the HiLo class as follows: 


II . 

II Data Me mb e r s 


pr i 

vat e 

final 

i nt 

MAX GUESS ALLOWED 

= 6; 

pri 

vat e 

final 

i nt 

LOWER BOUND 

= l; 

pr i 

vat e 

final 

i nt 

UPPER]BOUND 

= 100 

pr i 

vat e 

int secret 

N u mb e r ; 



We need to test two methods in this step. To verify the getNextGuess method, we 
input both invalid and valid guesses. We verify the method by running the following tests: 

1. Enter a number less than 1. 

2. Enter a number greater than 100. 

3. Enter a number between 2 and 99. 

4. Enter 1. 

5. Enter 100. 

The first two test cases are called error cases, the third is called the normal case, and 
the last two are called end cases. One of the common errors beginners make is to create a 
loop statement that does not process the end cases correctly. When our code handles all 
three types of cases correctly, we will proceed to test the playGame method. 

To verify the playGame method, we need to perform a more elaborate testing. 
Knowing that the dummy secret number is 45, we verify the playGame method by run¬ 
ning the following tests: 

1. Enter a number less than 45 and check that the correct hint LO is displayed. 

2. Enter a number greater than 45 and check that the correct hint HI is displayed. 

3. Enter the correct guess, and check that the game terminates after displaying the 
appropriate message. 

4. Enter six wrong guesses, and check that the game terminates after displaying the 
appropriate message. 

When all four tests are successfully completed, we proceed to the next step. 


Step 3 Development: Generate a Random Number 

In step 3, we add a routine that generates a random number between 1 and 100. As 
explained in Chapter 3, we can use the Random class. 
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6.11 Sample Development— continued 


step 3 code The generateSecretNumber method is defined thus: 

private void generateSecretNumber! ) { 

secret Number = random, nextl nt(100) + 1; 

System, out. printlnf" Secret Number: " + secretNumber); 

II TEMP 

} 

We include a temporary output statement to verify that the secret number is valid. Know¬ 
ing the secret number is also useful because we can stop the game anytime we want by 
entering the correct guess.The Random object random is a private data member and 
initialized in the constructor: 

private Random random; 


public Ch6Hi Lo ( ) { 

random = new Random! ); 

} 


To verify that the method generates correct random numbers, we will write a sepa¬ 
rate test program. If we don't use such a test program and instead include the method 
immediately in the Ch6HiLo class, we have to play the game, say, 100 times to verify that 
the first 100 generated numbers are valid. The test program generates N random num¬ 
bers and stops whenever an invalid number is generated. We will set N to 1000. Here's the 
test program: 


TestRan- 

dom class 
fortesting 


import java,util.*; 
class Test Random { 


public 

s 

t a t i 

C VO 

i d 

ma 

i n 

(S 

t r i 

ng 

ar gs 

;[]) { 

i n 

t 

N = 

1000 

, 

c o u 

nt 

= 

0, 

n u 

mbe r; 


Ra 

nd 

om r 

ando 

m 

= n 

e w 

Ra 

n d < 

3 m( 

); 


do 

{ 













coun 

t ++; 











n u mb 

er = 

r 

and 

o m. 

ne 

xt 1 

nt 

( 100) 

+ 1; 

} 

wh 

i 1 e 

( c ou 

nt 

< 

N && 








1 

< = 

n u 

mbe 

r 

&& 

n u 

mbe r 

<= 100 
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if (number < 1 || number > 100) { 

System, out. p r i n 11 n ( " Error: " + number); 

} else { 

System, out. pri ntl n ( " 0 k a y" ); 

} 

} 

} 

Keep in mind that successfully generating 1000 valid random numbers does 
not guarantee that the 1001st number is also valid. We did not offer any formal 
mathematical proof that the routine for the random number generator works correctly. 
What we are doing here is making an assumption that no user wants to play more than 
1000 Hi-Lo games in one session, which we believe is a practical and reasonable 
assumption. After the TestRandom class is executed correctly, we make the necessary 
changes to the Ch6HiLo class and run it. When we verify that the program runs as 
expected, we proceed to the final step. 

Step 4 Development: Finalize 

program We finalize the program in the last step. We will perform a critical review of the program, 
review looking for any unfinished method, inconsistency, or error in the methods; unclear or 

missing comments; and so forth. We should also not forget to keep an eye on any im¬ 
provement we can make to the existing code. 

We still have a temporary code inside the describeRules method, so we will 
complete the method by adding code to describe the game rules. This method is left as 
Exercise 18. 

There are still temporary output statements that we used for verification purposes. 
We can either delete them from the program or comment them out. We will leave them 
in the program by commenting them out so when the time comes for us to modify, 
debug, or update the program, we do not have to reenter them. 


Summary 


A repetition control statement is used to repeatedly execute a block of code 
until a certain condition is met. 

Three repetition control statements are while, do-while, and for. 

The count-controlled loop executes the loop body for a fixed number of 
times. 

The sentinel-controlled loop executes the loop body until any one of the 
designated values called a sentinel is encountered. 

Count-controlled loops can be implemented most naturally with the for 
statements. 


www.it-ebooks.info 




362 Chapter 6 Repetition Statements 


Sentinel-controlled loops can be implemented most naturally with the while 
or do-while statements. 

The while statement is called a pretest loop, and the do-while statement is 
called a posttest loop. The for statement is also a pretest loop. 

Reading a value before the loop statement is called a priming read. 

Off-by-1 error and infinite loop are two common mistakes in writing a loop 
control. 

The loop-and-a-half repetition control is the most general way of writing a 
loop. The break statement is used within the loop body to exit the loop when 
a certain condition is met. 

The nested for statement is used very often because it is ideally suited to 
process tabular data. 

Output values can be formatted by using the Formatter class. 

Execution time can be estimated by using the Date class. 


Key Concepts 


repetition statements 
while statements 
do-while statements 
for statements 
off-by-1 error 
infinite loop 
priming read 
nested for statements 


pseudocode 
loop-and-a-half control 
one-entry-one-exit control 
count-controlled loops 
sentinel-controlled loops 
pretest and posttest loops 
formatting output values 
recursive methods (optional) 


Chapter 6 Exercises 


Review Exercises 


1. Identify all the errors in the following repetition statements. Some errors are 
syntactical while others are logical (e.g., infinite loops). 

a. f or ( i nt i =10; i >0; i ++) { 

x = y; 
a = b; 

} 

b. i nt s u m = 0; 

Scanner scanner = new Scanner ( System, in); 

do { 

num = scanner. nextlnt(); 
s j m += num; 

} until ( sum > 1 0 0 0 0 ) ; 
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c. while (x < 1 && x > 10) { 
a = b; 

} 


d. whiIe (a == b ) ; 

{ 

a = b; 
x = y; 

} 

e. f o r ( i nt i =1.0; i <=2.0; i +=0.1) { 

x = y; 
a = b; 

} 


2. Write for, do-while, and while statements to compute the following sums 
and products. 

a. 1 + 2 + 3 + ■ ■ ■ + 100 

b. 5 + 10 + 15 + ■ ■ ■ + 50 

c. 1 + 3 + 7 + 15 + 31 + ■ ■ ■ + (2 20 - 1) 



e. 1 x 2 x 3 x ■ ■ ■ x 20 

f. 1 x 2 x 4 x 8 x ■ ■ ■ x 2 20 


3. What will be the value of sum after each of the foil owing nested loops is 
executed? 

a. sum = 0; 

for ( i nt i =0; i <=10; i ++) 

for ( i nt j =0; j <=10; j ++) 
s um += i ; 

b. sum = 0; 
j = 0; 

do { 

j ++; 

for ( int i =5; i > j ; i - - ) 
sum = sum + (i+j); 

} whiIe (j < 11); 

C. sum = 0; 

I = 0; 

while ( i < 5 ) { 
i = 5; 

whi I e ( i ! = j ) { 

sum += j ; 
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} 

i + + ; 

} 

d. sum = 0; 

for ( int i =0; i <=10; i ++) 

for (int j = 10; j > 2 * i ; j - - ) 
sum = sum + (j - i); 

4. Determine the output from the following code without actually executing it. 

System, out. f o r ma t ( " %4 d " , 2 3 4 ); 

System, out. f o r ma t ( " %5 d " , 2 3 4 ); 

System, out. f o r ma t ( " %s " , " \ n" ) ; 

System, out. f o r ma t ( " $ %6. 2 f", 2 3,4 5 6 ); 

System, out. f o r ma t ( " %s " , " \ n" ) ; 

System, out. f or mat ( " %1 $3d + %1 $3d = %2$5d" , 5, (5 + 5)); 

5. Rewrite the following nested for statements, using nested do-while and 
while statements. 

a. sum = 0; 

number = 0; 

for (int i =0; i <=10; i ++) 

for (int j =10; j >= i ; j - - ) { 

n u mb e r ++; 

sum = sum + (j - i); 

} 

b. product =1; 

number = 0; 

for (int i =1; i <5; i + + ) 

f or ( i nt j = 1; j < 5; j ++) { 

n u mb e r ++; 

product * = number; 

} 


Level 1 Programming Exercises ★ 

6 . Write a program to print out the numbers 10 through 49 in the following 
manner: 


10 11 12 13 14 15 16 17 18 19 
20 21 22 23 24 25 26 27 28 29 
30 31 32 33 34 35 36 37 38 39 
40 41 42 43 44 45 46 47 48 49 
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How would you do 

it? Here is an example of poorly written code: 

for ( i nt i = 

10; i < 50; 

++) { 


s wi t c h ( i ) 

{ 



case 19 




case 29 




case 39 

: S y s t e m. o u t 

p r i n 11 n ( " " + i 

; / / mo v e to the 


break; 


II next line 

default 

: S y s t e m. o u t 

print(" " + i ) ; 



} 

} 


This code is not good because it works only for printing 10 through 49. Try 
to develop the code so that it can be extended easily to handle any range of 
values. You can do this coding in two ways: with a nested for statement or 
with modulo arithmetic. (If you divide a number by 10 and the remainder is 
9, then the number is 9,19, 29, or 39, and so forth.) 

7. A prime number is an integer greater than 1 and divisible by only itself and 
1. The first seven prime numbers are 2, 3, 5, 7,11,13, and 17. Writea 
method that returns true if its parameter is a prime number. Using this 
method, write a program that repeatedly asks the user for input and displays 
Prime if the input is a prime number and Not Prime, otherwise. Stop the 
repetition when the input is a negative number. 

8 . Complete the loan table program discussed in Section 6.8. 

9. Implement the describeRules method of the ch6HiLo class from Section 6.9. 
At the beginning of the program, ask the user whether or not to display the 
game rules. 

10. The price table for carpet we printed out in Section 6.6 contains index values 
for width and length, but not labels to identify them. Write a program that 
generates the table shown next: 


EiYlCA, WINDOWS\System32\cmd.exe 






LENGTH 





5 

10 

15 

20 

25 


11 

1045 

2090 

3135 

4180 

5225 


12 

1140 

2280 

3420 

4560 

5700 


13 

1235 

2470 

3705 

4940 

6175 


14 

1330 

2660 

3990 

5320 

6650 

WIDTH 

15 

1425 

2850 

4275 

5700 

7125 


16 

1520 

3040 

4560 

6080 

7600 


17 

1615 

3230 

4845 

6460 

8075 


18 

1710 

3420 

5130 

6840 

8550 


19 

1805 

3610 

5415 

7220 

9025 


20 

1900 

3800 

5700 

7600 

9500 
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11. Extend the HiLo class to allow the user to designate the lower and upper 
bounds of the secret number. I n the original HiLo class, the bounds are set to 
1 and ioo, respectively. 

12. Improve the LoanCalculator class from Chapter 4 to accept only the valid 
input values for loan amount, interest rate, and loan period. The original 
LoanCalculator class assumed the input values were valid. For the exercise, 
let the loan amount between $100.00 and $1,000,000.00, the interest rate 
between 5 and 20 percent, and the loan period between 1 year and 30 years 
be valid. 


Level 2 Programming Exercises ★★ 

13. There are 25 primes between 2 and 100, and there are 1229 primes between 
2 and 10,000. Write a program that inputs a positive integer N> 2 and 
displays the number of primes between 2 and N (inclusive). Use the timing 
technique explained in Section 6.9 to show the amount of time it took to 
compute the result. 

14. Instead of actually computing the number of primes between 2 and N, 
we can get an estimate by using the Prime Number Theorem, which 
states that 


prime(W) = 


where prime(N) is the number of primes between 2 and N (inclusive). The 
function In is the natural logarithm. Extend the program for Exercise 13 by 
printing the estimate along with the actual number. You should notice the 
pattern that the esti mate approaches the actual number as the val ue of N gets 
larger. 

15. A perfect number is a positive i nteger that is equal to the sum of its proper 
divisors. A proper divisor is a positive integer other than the number itself 
that divides the number evenly (i.e., no remainder). For example, 6 is a 
perfect number because the sum of its proper divisors 1, 2, and 3 is equal 
to 6. Eight is not a perfect number because 1 + 2 + 4 Y= 8 . Write a 
program that accepts a positive integer and determines whether the number 
is perfect. Also, display all proper divisors of the number. Try a number 
between 20 and 30 and another number between 490 and 500. 

16. Write a program that lists all perfect numbers between 6 and N, an upper 
limit entered by the user. After you verify the program with a small number 
for 2V, gradually increase the value for Wand see how long the program takes 
to generate the perfect numbers. Since there are only a few perfect numbers, 
you might want to display the numbers that are not perfect so you can easily 
tell that the program is still running. 
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17. Write a program that displays all integers between low and high that are the 
sum of the cube of their digits. In other words, find all numbers jtyz such that 
xyz = x 3 + _y 3 + z 3 , for example, 153 = l 3 + 5 3 + 3 3 . Try 100 for low and 
1000 for high. 

18. Write a method that returns the number of digits in an integer argument; for 
example, 23,498 has five digits. U sing this method, write a program that 
repeatedly asks for input and displays the number of digits the input integer 
has. Stop the repetition when the input value is negative. 

19. Your freelance work with M yjava Lo-Fat Burgers was a success (see 
Exercise 24 of Chap. 5). The management loved your new drive-through 
ordering system because the customer had to order an item from each of the 
three menu categories. As part of a public relations campaign, however, 
management decided to allow a customer to skip a menu category. M odify 
the program to handle this option. Before you list items from each category, 
use a confirmation dialog to ask the customer whether he or she wants to 
order an item from that category. 

20. Extend the program in Exercise 15 so that customers can order more than 
one item from each menu category. For example, the customer can buy two 
orders of Tofu Burgers and three orders of Buffalo Wings from the Entree 
menu category. 

21. A formula to computetheMh Fibonacci number was given in Exercise 10 in 
Chapter 3. The formula is useful in finding a number in the sequence, but a 
more efficient way to output a series of numbers in the sequence is to use the 
recurrence relation F N = F n -i + F N - 2 , with the first two numbers in the 
sequence Fi and F 2 both defined as 1. Using this recurrence relation, we can 
compute the first 10 Fibonacci numbers as follows: 


FI = 1 
F 2 = 1 


F 3 

= F 2 

+ 

FI 

= 1 

+ 

1 

= 2 

F 4 

= F 3 

+ 

F 2 

= 2 

+ 

1 

= 3 

F 5 

= F 4 

+ 

F 3 

= 3 

+ 

2 

= 5 

F 6 

= F 5 

+ 

F 4 

= 5 

+ 

3 

= 8 

F 7 

= F 6 

+ 

F 5 

= 8 

+ 

5 

= 13 

F 8 

= F 7 

+ 

F 6 

= 13 

+ 

8 

= 21 

F 9 

= F 8 

+ 

F 7 

= 21 

+ 

13 

= 34 

F10 

= F 9 

+ 

F 8 

= 34 

+ 

21 

= 55 

Write a program 

that accepts 

N, 

iV> 1, from the user and displays the first TV 


numbers in the Fibonacci sequence. Use appropriate formatting to display 
the output cleanly. 

22. M odify the program of Exercise 21 to generate and display all the numbers 
in the sequence until a number becomes larger than the value maxNumber 
entered by the user. 


www.it-ebooks.info 


368 


Chapter 6 Repetition Statements 


23. In the formatting examples from the chapter, wealways provided a fixed 
control string, such as 

System, out. f o r ma t ( " %4 d " , 23); 

It is possible, however, to dynamically create the control string, as in 

i nt i = 4; 

System, out. f o r ma t ( " %" + i + ' d " , 23); 

Using this idea of dynamically creating a control string, write a code 
fragment that outputs 50 X *s, usi ng a separate I i ne for each X. A n X on a 
single line is preceded by two more leading spaces than the X on the 
previous line. The following figure shows the output for the first five 
lines. 


X 

X 

X 

X 

X 

24. Write a program that inputs N, where 3 <= N <= 25, and outputs a cross. 
The following figure shows the output when TV is 5. 


X X 

X X 

X 

X X 

X X 


Use the technique explained in Exercise 22. 

25. (Optional) Write a recursive method to compute the sum of thefirstw 
positive integers. Note: This is strictly for exercise. You should not write the 
real method recursively. 

26. ( Optional ) Write a recursive method to compute the sum of the first 2V 
positive odd integers. Note: This is strictly for exercise. You should not write 
the real method recursively. 
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Level 3 Programming Exercises ★★★ 

27. You can compute sin x and cos* by using the following power series: 




Write a program that evaluates sin x and cos x by using the power series. Use 
the double data type, and increase the number of terms in the series until the 
overflow occurs. You can check if the overflow occurs by comparing the 
value against Double, positivejnfinity. Compare the results you obtain to 
the values returned by the sin and cos methods of the Math class. 

28. Extend Exercise 22 on page 300 by drawing a more realistic clock. Instead 
of drawing a clock like this 



draw a circle at 5-min intervals as follows: 



Use a for loop to draw 12 circles. 

29. Write an application that draws nested N squares, where N is an input to the 
program. The smallest square is 10 pixels wide, and the width of each 
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successive square increases by 10 pixels. The foil owing pattern shows seven 
squares whose sides are 10, 20, 30,..., and 70 pixels wide. 


Drawing Board 




□ 





not drawn to scale 


Development Exercises 

For the following exercises, use the incremental development methodology to 
implement the program. For each exercise, identify the program tasks, create a 
design document with class descriptions, and draw the program diagram. M ap out 
the development steps at the start. Present any design alternatives and justify your 
selection. Be sure to perform adequate testing at the end of each development step. 

30. The monthly payments for a given loan are divided into amounts that apply 
to the principal and to the interest. For example, if you make a monthly 
payment of $500, only a portion of the $500 goes to the principal and the 
remainder is the interest payment. The monthly interest is computed by 
multiplying the monthly interest rate by the unpaid balance. The monthly 
payment minus the monthly interest is the amount applied to the principal. 
The following table is the sample loan payment schedule for a 1-year loan of 
$5000 with a 12 percent annual interest rate. 


Payment 

No. 

1 nterest 

Principal 

Unpaid 

Balance 

Total Interest 
to Date 

1 

50.00 

394.24 

4605.76 

50.00 

2 

46.06 

398.19 

4207.57 

96.06 

3 

42.08 

402.17 

3805.40 

138.13 

4 

38.05 

406.19 

3399.21 

176.19 

5 

33.99 

410.25 

2988.96 

210.18 

6 

29.89 

414.35 

2574.61 

240.07 

7 

25.75 

418.50 

2156.11 

265.82 

8 

21.56 

422.68 

1733.42 

287.38 

9 

17.33 

426.91 

1306.51 

304.71 

10 

13.07 

431.18 

875.34 

317.78 

11 

8.75 

435.49 

439.85 

326.53 

12 

4.40 

439.85 

0.00 

330.93 
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Write a program that accepts a loan amount, annual interest rate, and 
loan period (in number of years) and displays a table with five columns: 
payment number, the interest and principal paid for that month, the 
remaining balance after the payment, and the total interest paid to date. 

Note: The last payment is generally different from the monthly payment, 
and your program should print out the correct amount for the last payment. 
Use the Format class to align the output values neatly. 

31. Instead of dropping a watermelon from a building, let's shoot it from a cannon 
and compute its projectile. The (x,y) coordinates of a watermelon at time rare 

x = Vcos(ot) ■ r 

g ■ f 2 

y = V sin(a) ■ r — 

where g is the acceleration of gravity, V is the initial velocity, and a (alpha) 
is the initial angle. The acceleration of gravity on earth is 9.8 m/s 2 . 



Writea program thatinputs an initial velocity v (m/s) and an initial angle 
alpha (degrees) and computes the projectile of a watermelon cannon ball. 

The program should repeat the computation until the user wants to quit. The 
program outputs the (x, y) oordinate value for every second, that is, t = 0, i, 2, 
and so forth. The program stops the output when the y value becomes o or 
less. To use the cos and sin methods of the Math class, don’t forget that you 
have to convert the input angle given in degrees to radians. You can convert a 
degree to equivalent radians by using the following 


Radian 


degree x n 
180 


or calling thetoRadians method of the Math class. Wore: Air resistance is not 
considered in the formula. Also, we assumed the watermelon will not get 
smashed upon firing. 

32. Write a program that simulates a slot machine. The player starts out with 
M coins. The value for M is an input to the program, and you charge 25 cents 
per coin. For each play, the player can bet 1 to 4 coins. If the player enters 0 
as the number of coins to bet, then the program stops playing. At the end of 
the game, the program di spl ays the number of coi ns I eft and how much the 
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player won or lost in the dollar amount. There are three slots on the machine, 
and each slot wi II display one of the three possible pieces: BELL, GRAPE, 
and CHERRY. When certain combinations appear on the slots, the machine 
will pay the player. The payoff combinations are as follows: 


No. 

Combination 

Payoff 

Factor 

1 

BELL 

BELL 

BELL 

10 

2 

GRAPE 

GRAPE 

GRAPE 

7 

3 

CHERRY 

CHERRY 

CHERRY 

5 

4 

BELL 

BELL 


3 

5 

BELL 


BELL 

3 

6 


BELL 

BELL 

3 

7 

GRAPE 

GRAPE 


1 

8 

GRAPE 


GRAPE 

1 

9 


GRAPE 

GRAPE 

1 


The symbol.means any piece. If the player bets 4 coins and get 

combination 5, for example, the machine pays the player 12 coins. 
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Objectives 


After you have read and studied this chapter,you 
should be able to 

• Define overloaded methods and constructors. 

• Describe the uses of the reserved word this. 

• Define class methods and variables. 

• Describe how the arguments are passed to the 
parameters in method definitions with the 
pass-by-value scheme. 

• Describe how objects are returned from 
methods. 

• Document classes with javadoc comments. 

• Organize classes into a package. 
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Intro 



return objects 
from methods 


d u c t i o n 


n Chapter 4, we covered the basics of programmer-defined classes with illustrative 
examples. There we focused our attention on straightforward cases. After seeing 
more sample programs in Chapters 5 and 6, we are now ready to attack advanced 
topics of programmer-defined classes. In addition to introducing several new topics, 
we will revisit some of the topics from Chapter 4 and provide a more in-depth dis¬ 
cussion. In Chapters 5 and 6, we used the Fraction class to illustrate some of the 
concepts. We will continue to use the Fraction class in this chapter to illustrate the 
key concepts introduced here. Toward the end of this chapter, we will provide a 
complete definition of the Fraction class. In addition to this Fraction class, we will 
go over other sample classes to help students master the key concepts. 


7.1 Returning an Object from a Method 

Up until now, when we define a value-returning method, we return either primitive 
data types, such as int or boolean, or a string. I n this section, we learn how to return 
objects from methods. Again, a string is an object, so in a sense, we know how to re¬ 
turn an object from a method. However, a string is treated much as a primitive 
datum for the most part. H ere, we provide a more complete picture of what is going 
on when we return an object of other standard and programmer-defined classes. 

We use the Fraction class to illustrate the returning of an object from a 
method. Here's the portion of the class definition that includes the constructor, 
accessors, and mutators (we will add other methods gradually as we cover more 
topics): 


class Fraction { 

We assume both 
parameters are 
nonnegative. 

We remove this 
assumption 
when listing the 
final version in 
Section 7.8. 

return denominator; 

} 

public int get Numerator! ) { 
return numerator; 

} 


private int numerator; 

private int denominator; 

public Fraction(int num, int denom) { 
setNumerator(num); 
set Denomi nator(denom); 

} 

public i nt get Denomi nat or ( ) { 
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public void set Denomi nator( i nt denom) { 
if (denom == 0) { 

//Fatal error 

System, err. p r i n 11 n ( " Fatal Error"); 

Syst em, exi t ( 1) ; 

} 

denominator = denom; 

} 

public void set Numerator! i nt num) { 
numerator = num; 

} 

public String toStringl ) { 

return getNumerator() + "/" + get Denominator!); 

} 

//other methods come here 

} 

Notice that we do not allow a fraction to have 0 as its denominator. If there is an 
attempt to assign 0 as a fraction's denominator, we will terminate the whole pro¬ 
gram. This is quite a draconian measure, but we will do it this way until we learn ex¬ 
ception handling in Chapter 8. 

Now, let's study the simplify method that reduces a fraction to its simplest 
form. How about the following? 

public void simplify! ) { 

int num =getNumerator(); 
i nt denom = get Denomi nat or () ; 
int gcd = g c d ( num, denom); 

set Numerator! num/ gcd) ; 
set De no ml nator( denom/ gcd) ; 

} 

We use the gcd method that returns the greatest common divisor (int) as de¬ 
scribed in Chapter 6. We get the simplified form by dividing the numerator and the 
denominator by their greatest common divisor. Here's a sample use of the method: 

Fraction fl = new Fracti on(24, 36); 
fl.simplify! ); //fl Is changed! 

Notice that the value of fl is now changed because the method updates the data 
members of the receiving object (in this example, fl is a receiving object because 
we are calling the add method of fl). 

Is it acceptable to change the values of the receiving object fl? Inthiscase, no. 
Instead, it is better to keep the values of fl unchanged and to return a new Fraction 
object that is in the simplified form. This will give flexibility to client programmers. 
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Here's the improved version of the simplify method. (We will make an additional 
improvement in Section 7.8 to properly handle the case when gcd iszero.) 

public Fraction simplify) ) { 

int num = getNumerator(); 
int denom = getDenominator(); 
int gcd = g c d ( num, denom); 

Fraction simp = new Fracti on(num/gcd, denom/ gcd); 

return s i mp; 

} 

The following is the sample use of the improved version: 

Fraction f 1, f 2; 

fl = new Fracti on(24, 36); 

f 2 = f 1. s i mpl i f y( ) ; 

System, out. pri ntl n(fl.toStri ng() + "can be reduced to " + 
f2. t oSt ri ng( )) ; 

The output will be 


24/36 can be reduced to 2/3 I 

Be aware that we can produce such output easily becausewedid not change the val¬ 
ues of f 1. Now, if we really want to reduce fi itself to simplest form, then we just 
have to assign the result back to fi as in 

f 1 = f 1. s i mpl i f y( ) ; 

Let's study the effect of the simplify method when it returns an object. Fig¬ 
ure 7.1 shows the state of memory after the simp object is created and assigned the 
values. Notice that simp is a local variable, but the object itself is created in the heap 
memory. The return statement at the end of the simplify method returns the value of 
simp, which is a reference to the Fraction object. Figure 7.2 shows the state after the 
simplify method is complete. The value of simp is assigned to f 2 , and now the vari¬ 
able f2 points to this Fraction object. It is critical to realize that when we say return 
an object from a method, we are in fact returning a reference to the object. 


^jjings to Remember 

When we say "return an object from a method," we are actually returning the 
address, or reference, of an object to the caller. 
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f2 = f1. simplify( ) ; 



publ i C Fraction simplify( ) { 
Fraction simp; 
simp = new Fraction! . . .) 


At (T) before return 


return simp; 

} 


simp 


IS®—1 





Only the local variable 
simp is shown here. 


Figure 7.1 This illustration shows the state after the simp object is created and assigned with the correct values. 



At (F) after simplify is complete 


publ i C Fraction simplify!) { 
Fraction simp; 
simp = new Fraction! .. . ) ; 
return simp; 

> 



Figure 7.2 Continuation of Figure 7.1 .This illustration shows how an object (actually the reference to it) is 
returned to the calling program. 
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Wewill be seeing more examples of object-returning methods in this and later 
chapters. 



It is not necessary to create an object for every variable we use. Many novice pro¬ 
grammers often make this mistake. For example, we write 


Fraction f 1, f 2; 
fl = new Fraction(24, 
f 2 = f 1. s i mpI i f y( ) ; 


36) 


We didn't write 


Fraction fl, f 2; 
f1 = new Fr action(24, 
f 2 = new Fr action( 1, 

f 2 = f 1. s i mpI i f y( ) ; 


36) 

l); 


II not necessary 


because it is not necessary.The simplify method returns a Fraction object, and in 
the calling program, all we need is a name we can use to refer to this returned 
Fraction object. Don't forget that the object name (variable) and the actual object 
instance are two separate things. 


W 

Quick 

CHECK 


1. What’s wrong with the following declaration? 

cl ass Quest ion { 

Person student; 

public void get St udent ( ) { 

return student; 

} 


} 

2. Define a Vehicle class. It has a data member owner of type Person. Include 
an accessor to retrieve the owner person and a mutator to set the owner. 


7.2 


The Reserved Word this 


Let's continue the implementation of the Fraction class. We now consider the four 
arithmetic operations for fractions; see Figure 7.3. When defining the methods for 
the four arithmetic operations, we introduce the use of the reserved word this. The 
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Addition f + -, = ad , 1 , hc Subtraction f - § = ad ,, bc 

b a bd b a bd 

Division = Multiplication f x | 


Figure 7.3 Rules for adding, subtracting, multiplying, and dividing fractions. 

seif- reserved word this is called a self-referencing pointer because it is used to refer to 

referencing the receiving object of a message from within this object's method. 
pointer Let's start with the add method that adds two fractions: 

public Fraction add ( Fraction frac) { 
i nt a, b, c, d; 

Fraction sum; 

a = thi s. getNumerator(); II get the receiving 

b = thi s. getDenomi nator() ; //object's num and denom 

c = frac.getNumeratorf); II get frac's num 

d = frac. getDenomi natorf); II and denom 

sum = new Fracti on(a*d + b*c, b * d ); 

return sum; 


} 

Let's first look at how this add method is used. The following code adds two 
fractions fi and f2 and assigns the sum to f3: 


Fraction f 1, f 2, f 3; 

fl = new F r a c ti o n ( 1, 2); 
f 2 = new Fr acti on( 1, 4); 

f 3 = f 1. add ( f 2) ; 

System, out. p r i n 11 n (" Sum of " +fl.toString() +" and " + 

f 2.t o S t r i n g () + " is " + 
f 3.t oSt ri ng( ) ; 

This code, when executed, will produce the following output: 


Sum of 1/2 and 1/4 is 6/8 

Not simplified because 
the simplify method is 
not called. 
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I n the statement 

f 3 = f1.a dd ( f 2 ) ; 

we are cal ling the add method of fi and passing the argument f 2 . So in this case, the 
receiving object is fi. Figure 7.4 shows the state of memory at the point where the 
add method of fi is called. Notice that the self-referencing pointer this is referring 
to fi because it is the receiving object. 

Because f2 is also a Fraction object, we can write the statement as 

f 3 = f 2. add ( f 1) ; 

and get the same result (since the operation is addition). In this case, the receiv¬ 
ing object is f2, and the argument is fi. Figure 7.5 shows the state of memory at 
the point where the add method of f2 is called. Notice how the objects referenced 
by frac and this are swapped. This time the self-referencing pointer this is refer¬ 
ring to f 2 . 


f3 = fl ,add( f2) ; 


At (T) when the method is called 



public Fraction add( Fraction frac) f(T) 
Fraction sum; 
sum = new Fraction( . . . ) ; 
return sum; 



this points to fl 


Figure 7.4 This illustration shows the state of memory for f1.add(f2). 
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f 3 = f 2 . add( f 1) ; 


At (T) when the method is called 



public Fraction add(Fraction frac) {(T) 
Fraction sum; 
sum = new Fraction( . . .) ; 
return sum; 



this points to f2 


Figure 7.5 This illustration shows the state of memory for f2.add(f1). 


The add method computes the sum of the receiving Fraction object and the 
argument Fraction object. We used the identifier frac for the parameter, so 

c = frac.getNumerator(); 
d = frac.getDenomi nator(); 


will retrieve the numerator and the denominator of the argument Fraction 
object. 

To retrieve the numerator and the denominator of the receiving Fraction 
object, we write 


a = thi s. get Numerator! ) ; 
b = this.getDenomi nator(); 


because the reserved word this refers to the receiving object. 
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The use of the reserved word this is actually optional. If we do not include it 
explicitly, then the compiler will insert the reserved word for us. For example, if we 
write 


class Samp I e { 

public void ml ( ) { 

} 

public void m2 ( ) { 

ml(); 

} 

} 

then the compiler will interpret the definition as 
class Samp I e [ 

public void ml ( ) { 

} 

public void m2 ( ) { 

... . , . The reserved word this is 

t hi s. ml ; 

j added by the compiler. 

} 

This is the reason why we were able to call a method from another method of 
the same class without the use of dot notation. In fact, it was dot notation with the 
reserved word this. We will discuss the use of this when referring to data members 
of class at the end of this section. 

The methods for the other three arithmetic operations are defined in a similar 
manner: 


public Fraction di vi de( Fracti on frac) { 
i nt a , b, c , d; 

Fraction quotient: 

a = this.getNumeratorl); 
b = thi s. getDenomi nator() ; 
c = frac. getNumerator(); 
d = frac. getDenomi nator(); 

quotient = new Fracti on ( a *d, b * c ); 

return quotient; 
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public Fraction mul ti pi y(Fracti on frac) { 
i nt a, b, c, d; 

Fraction product; 

a = this. getNumerator(); 
b = thi s. getDenomi nator( ); 
c = frac. get Numerator! ) ; 
d = frac.getDenomi nator(); 

product = new Fracti on ( a *c, b*d); 

return product; 

} 

public Fraction subtract ( Fracti on frac) { 
i nt a, b, c, d; 

Fraction diff; 

a = this. getNumeratorf); 
b = thi s. getDenomi natorf ); 
c = frac. getNumeratorf); 
d = frac.getDenomi natorf); 

diff = new Fracti on(a*d - b * c, b*d); 

return diff; 

} 

We could have defined the four arithmetic methods as void methods, instead 
of returning the result as a Fraction object. But doing so will severely limit the flex¬ 
ibility. Because the methods are object-returning methods, we can write a statement 
such as 


f 3 = f 1. add ( f 2) ; 

that reflects the mathematical expression 

f 3 = f 1 + f 2 

naturally. M oreover, because the add method returns a Fraction object as the sum, 
we can compose the calls to implement multiple additions. For example, the math¬ 
ematical expression 

f 4 = f 1 + f 2 + f 3 

can be written as 

f 4 = f 1. a d d ( f2. addff3) ); 
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where the sum of f 2 and f3 is passed as an argument to the add method of f i . We can 
also write the expression as 

f 4 = f1. add( f 2).add( f 3) ; 

because fi.add(f2) refers to a (unnamed) Fraction object, and we can call this un¬ 
named object's add method with f3 as an argument. 


Another Use of this 

Consider the following class declaration: 

class Music C D { 

private String artist; 

private String title; 

private String id; 

public Musi cCDfStri ng namel, String name 2) { 

artist = namel; 
title = n a me 2; 

id = artist, substring!!), 2) + " - " + 
ti11 e. subst ri ng( 0, 9) ; 


} 

} 

The constructor has two string parameters, one for the artist and another for the 
title. A n id for a MusicCD object is set to be the first two letters of the artist name 
followed by a hyphen and the first nine letters of the title. 

Now, consider what happens if we include (say, inadvertently) a local decla¬ 
ration for the identifier id like this: 


Local declaration 

for id. 


This id is now a 
local variable. 


public Musi cCD( St ri ng namel, String name 2) { 
String id; 


a r ti st 
title 
■ d 


= n a me 1; 

= n a me 2; 

= artist, substring)!), 2) + 
t i 11 e. s ubst r i ng( 0, 9); 


+ 


Because there is a matching local declaration for id, the identifier refers to the local 
variable, not to the third data member anymore. When an identifier is encountered 
in a method, the following rules are applied to determine the association. 
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iThings to Remember 



Rules for associating an identifier to a local variable, a parameter, and a data 
member 

1. If there's a matching local variable declaration or a parameter, then the 
identifier refers to the local variable or the parameter. 

2. Otherwise, if there's a matching data member declaration, then the identifier 
refers to the data member. 

3. Otherwise, it is an error because there's no matching declaration. 


W hy does thej ava compi I er not catch such an error? W hen woul d anyone want 
to use the same identifier for both the data member and the local variable or parame¬ 
ter? It is true that we strongly recommend to always use an identifier different from 
any data member in declaring a local variable. But there is a situation in which we 
may want to use the same identifier for a parameter and a data member. In the 
MusicCD constructor, we declared the parameters namei and name2 to avoid naming 
conflict. It would actually be more meaningful to use the conflicting identifiers artist 
and title. To do so, we rewrite the method by usi ng the reserved word this as fol lows. 


This refers to the 
data member. 


public MusicCD(Stri ng artist, String title) { 


(t his. a r t i s t') = (a r t i s t;'} 
t his . t i f I e = title; 
id = artist, substrings, 2) 
title.substrings, 9); 

} 


This refers to the 
parameter. 

+ " - ‘ + 


Following the stated rules, the identifier artist refers to the parameter. To refer 
to the data member artist from within this constructor, we prefix the identifier artist 
with the reserved word this, using dot notation, as this.artist. In the modified con¬ 
structor, we did not use the reserved word this to refer to the data member id because 
it was not necessary. Its use is optional, so we could have written 

this. id = artist, substring)!), 2) + + 

title, substrings, 9); 


to make the code look more consistent. The reserved word this can always be used to 
refer to the receiving object's data members, whether there is a naming conflict or not. 


livings to Remember 



Optionally, dot notation with the reserved this can be used to refer to an object's 
data member from the object's methods and constructors. 
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In general, following the common practice, we do not use dot notation (with 
the reserved word this) to refer to an object's data members from the object's meth¬ 
ods unless it is necessary. 

Note that we can also avoid the naming conflict and still use a meaningful 
name for a parameter by prefixing an article to the parameter. For example, we 
could use the identifiers anArtist and aTitle instead of namei and name2. This nam¬ 
ing will not conflict with the data members, so the use of the reserved word this is 
not necessary in the constructor. As long as you use meaningful identifiers, which 
technique you adopt to avoid naming conflict is more of a personal preference. 


W 

Quick 

C T 


1. Write a single statement to express the following operations on fractions, using 
the methods from the Fraction class. 

f 5 = (fl + f 2 ) / ( f 3 - f 4 ) 

2. If the add method is defined thus 

public void add(Fracti on frac) { 
i nt a , b , c , d ; 

a = this. getNumerator(); II get this fraction's 
b =this.getDenominator(); //numand denom 

c = frac.get Numerator! ); II get frac's num 

d = frac.get Denominator!); //and denom 

setNumerator(a*b + c * b ) ; //updates this 
setDenomi nator(b*d); //fraction's numand denom 

} 

why is it wrong to call the method as follows? 

f 3 = f 1. add! f 2) ; 

3. Write statements to assign the sum of fractions fi and f2 to fraction f3, 
using the add method defined in question 2. 


7.3 Overloaded Methods and Constructors 

Let's continue to improve the Fraction class. Given the Fraction class in its cur¬ 
rent form, how can a client programmer express the following mathematical 
expression? 

f 3 =2/3 +9 


www.it-ebooks.info 



7.3 Overloaded Methods and Constructors 387 


One way is to convert the integer 9 to a fraction 9/1 and then use the add method. 

Fraction f 1, f 2, f 3; 

f1 = new F r a c tio n ( 2, 3); 
f 2 = new F r a c tio n ( 9, 1); 

f 3 = f 1. add ( f 2) ; 

This is not bad, but it would be nicer if we could write something like this: 

Fraction f1, f 3; 
f1 = new F r a c tio n ( 2, 3); 
f 3 = f 1. add ( 9) ; 

In other words, instead of passing a Fraction object, we want to pass a simple inte¬ 
ger value. Of course, with the current Fraction class, the statement 

f 3 = f 1. add ( 9) ; 

will result in an error because no matching method is defined in the class. So what 
we want here is two versions of addition, one that accepts a Fraction object and 
another that accepts an integer. Here are the two definitions: 

//Version 1 

public Fraction add( Fracti on frac) { 

II s a me as before 


overloaded 

methods 


} 

//Version 2 

public Fraction a d d ( int number) { 


Fraction sum; 
i nt a, b, c, d; 

a = getNumeratorf); 
b = getDenomi nator(); 
c = number; 
d = 1; 

sum = new Fracti on(a*d 
return sum; 


Including d here is redundant because its 
value is I.We include it here anyway for 
the sake of clarity. 

+ c* b, b*d); 


With the second add method, wenow have two methods in theclass that have 
the same name. This is not a problem as long as certain rules are met. The methods 
having the same name are called overloaded methods. 


www.it-ebooks.info 


388 Chapter 7 Defining Your Own Classes—Part 2 


method 

signature 


M ultiple methods can share the same name as long as one of the following 
rules is met: 

1. They have a different number of parameters. 

2. The parameters are of different data types when the number of parameters is 

the same. 

The two add methods of the Fraction class satisfy the second rule. The fol¬ 
lowing is an example in which two methods satisfy the first rule: 

public void myMet hod( i nt x, i nt y) { ... } 

public void myMet hod( i nt x) { ... } 

M ore formally, we say two methods can be overloaded if they do not have the 
same signature. The method signature refers to the name of the method and the 
number and types of its parameters. The two myMethod methods have different sig¬ 
natures because the data types of the second parameter are different. 

Two methods cannot be overloaded just by the different return types because 
two such methods would have the same signature. For example, the following two 
methods cannot be defined in the same class: 

public double getl nfo(Stri ng item) { ... } 

public int getl nfo(Stri ng item) { ... } 

Now, let's look at the second add method again. Instead of defining it as we 
have, we can define it by calling the first add method. Here's how: 

II More concise Version 2 

public Fraction a d d ( i n t number) { 

Fraction frac = new Fracti on(number, 1); 

Fraction sum = add(frac); //calls the first add method 

return sum; 

} 

In defining overloaded methods, it is common for oneof them to call another. Such 
implemenation indicates their relationship clearly—that they are different versions 
of the same logical operation. It also makes the modification easier becauseweneed 
to change the code in only one method. Other methods calling this method require 
no changes. We can define the overloaded methods for the other three arithmetic 
operations in a similar manner. 


Overloading Constructors 

Up until now, our programmer-defined classes included exactly one constructor. 
B ut a constructor is also a method, so it, too, can be overloaded. I ndeed, it is much 
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multiple 

constructors 


copy 

constructor 


more common to define multiple constructors in a programmer-defined class. The 
same rules for overloaded methods apply. Defining multiple constructors for a class 
gi ves the cl I ent programmer flexibility in creati ng i nstances. T he cl i ent programmer 
can pick one of the several constructors that is suitable for her needs at hand. Let's 
define multiple constructors for the Fraction class. Here are the four constructors 
(including the one already defined before at the bottom): 

public Fraction! ) { //creates 0/1 
setNumerator(O); 
set Denomi nator(l); 

} 

public Fraction(int number) { //creates number /1 
setNumerator(number); 
set Denomi nator(l); 

} 

public Fracti on ( Fracti on frac) { //copy constructor 
setNumerator(frac.getNumerator()); 
set Denomi nator(frac. get Denomi n a t o r () ); 

} 

public Fraction(int num, int denom) { 
setNumerator(num); 
set Denomi nator(denom); 

} 

The third constructor that accepts a Fraction object and creates a copy of the 
passed Fraction object is called a copy constructor. A copy constructor can be quite 
handy when we need to create instances of a class that includes many data mem¬ 
bers. Often we want to create a copy before changing the values of or experiment¬ 
ing with the original object. 

As another example, here's a Bicycle class with two constructors that initialize 
the two data members: 

class Bicycle { 

II Data Me mbe r s 

private String id; 

private String ownerName; 

II Constructors 

publ i c Bicyclef ) { 

id = "XXXX-XXXX"; 
owner Name = "Unassigned"; 

} 
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public Bi cycl e(Stri ng t a g N o, String name) { 

id = t a g No; 
owner Name = name; 

} 

II the rest of the class 


Calling a Constructor From Another Constructor by Using this 
The last use of the reserved word this is to call a constructor from another con¬ 
structor of the same class. Here's how we can rewrite the four constructors of the 
Fraction class by using the reserved word this: 


public Fraction) ) { II creates 0/1 

t hi s(0, 1); 

} 

public Fracti on(i nt number) { // creates number/1 
thi sfnumber, 1); 

} 

public Fracti on ( Fracti on frac) { II copy constructor 
this) f rac. getNumerator)), 

frac. getDenomi nator() ); 

} 

This constructor is 

called by the other public Fracti on(i nt num, int denom) { 

three constructors. s e t N u me ratorfnu m) ; 

set Denomi nator(denom); 

} 

The syntax for calling a constructor from another constructor of the same 
class is 


this) <parameter-list> ); 

The constructor that matches the parameter list will be called. We can add more 
statements after the this statement in a constructor, but not before it. In other words, 
the cal I to this in a constructor must be the first statement of the constructor. 


bings to Remember 



When you use this to call a constructor from another constructor of the same class, 
the this statement must be the first statement in the constructor. 
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w 

Quick 

CHECK 


1. Are there any conflicts in the following three constructors for ClassX to be 
valid? 

public Cl ass X ( i nt X ) { 

} 

publ i c Cl a s s X ( float X ) { 


} 

publ i c Cl ass X( i nt Y ) { 


2. Define a student class. A student has a name. Define two constructors, one 
with no argument and another with the name as its argument. Initialize the 
name to a default value Unknown for the zero-argument constructor. 

3. Rewrite the following constructors, so the first one calls the second one. 

public Class On e ( int alpha) { 
this. alpha = alpha; 
t hi s. beat = 0; 

} 

public Cl assOnef i nt alpha, i nt beta) { 

this. alpha = alpha; 
this. beta = beta; 


7.4 


Class Variables and Methods 


We introduced the concepts of class methods, class variables, and class constants in 
Chapter 1. We saw how class constants are declared in the actual Java statements in 
Chapter 4. We complete our study of class components in this section by describing 
how class methods and class variables are used in Java programs. Let's begin with 
the class methods. 

The Math class includes a class method called min to compare two numbers. 
We use this class method as follows: 


i n t i , j , s ma I I e r; 


s ma I I e r = Ma t h. mi n ( I , j ) ; 
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Now suppose we want to have a method to find the smaller of two Fraction objects. 
Where do we define such a method? The logical place is, of course, the Fraction 
class. But will this method be an instance method? No, a class method, which fol¬ 
lows the pattern of the min method of the Math class, is most appropriate. We can 
define a class method called min that accepts two Fraction objects as arguments and 
returns the smaller fraction. Here'show we define the min method: 

class Fraction { 


public static Fraction mi n(Fracti on f1, Fraction f 2 ) { 

II convert to decimals and then compare 

double f 1 _dec = fl. deci mal (); 
double f 2 _ d e c = f2. deci mal (); 

if ( f 1 _dec <= f2_dec) { 

return f 1; 

} else { 

return f 2; 

} 

} 

private double decimal) ) { 

//returns the deci mal equivalent 

return (double) getNumerator)) / getDenominator)); 

} 

} 

The reserved word static indicates that the min method is a class method. A 
cl ass method i s cal I ed by usi ng dot notati on w i th the cl ass name. H ere's a sampl e use: 

Fraction fl, f 2, smaller; 

fl = new Fracti on(l, 6); 
f2 = new Fracti on(4, 5); 

smaller = Fraction, ml n ( f 1, f 2 ); 

Remember, in Chapter 6 we discussed the need for finding the greatest com¬ 
mon divisor of two integers to simplify a given fraction. Following the logic of the 
min method, we can define the gcd method as a class method. Here's how: 

public static int gcdfint m, int n) { 

II the code implementing the Euclidean algorithm 

} 
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Notice that the arguments to this method are two integers. When this method is 
called from another method of the Fraction class, the numerator and the denomina¬ 
tor are passed as the arguments. We declare this method public so the client pro¬ 
grammers of the Fraction class can use it also. If this is not necessary, then we can 
declare it private. [Note: Logically, the gcd method should be a class method, but 
there will be no serious consequences if we define it as an instance method.) 

In a manner similar to the min and gcd methods, we can define the methods 
for arithmetic operations as class methods. For example, here's how: 

public static Fraction add(Fracti on f 1, Fraction f 2 ) { 

i nt a , b , c , d ; 

Fraction sum; 

a = fl.getNumeratorf); 
b = fl. getDenomi nator(); 
c = f2,getNumerator(); 
d = f2. getDenomi nator(); 

sum = new Fracti on(a*d + b*c, b * d ); 

return sum; 

} 

To use this class method, we write something like this: 

Fraction x = new F r a c tio n ( 1, 8); 

Fraction y = new F r a c tio n ( 4, 9); 

Fraction sum = Fraction, a d d ( x, y); 

The class method add, however, becomes awkward when we try to compose 
additions. To add three fractions x, y, and z, for example, we have to write 

Fraction sum = Fraction, add(Fraction,add(x,y), z); 

The instance method add, as we defined at the beginning of the chapter, 
allows a lot more natural and flexible use. 

N ow let's look at an example of class variables (we have been usi ng class con¬ 
stants sinceChap. 4). Suppose we want to assign atag number automatically when 
a new instance of the Bicycle class is created. We want the tag numbers to be 
ABC-101 , abc-102, ABC-103, and so forth. What we need to define in the Bicycle 
class is a counter that counts up from 101. Only one counter is necessary for the 
whole class, so it is logical to define this counter as a class variable. 

F i rst, w e decl are and i ni ti al i ze the cl ass vari abl e counter: 

class Bicycle { 

private static i nt counter = 101; 


} 


www.it-ebooks.info 


394 Chapter 7 Defining Your Own Classes—Part 2 


static initializer 


Then we adjust the constructor, so the id of a bicycle is assigned correctly. Here's 
how: 


publ i c Bicycle) ) { 

id = "ABC- 11 + counter; 

c o u n t e r ++; 


} 

Static Initializer 

There are cases in which we may need to do more than a simple assignment to ini¬ 
tialize a class variable. For example, we may be required to read the starting value 
for the class variable counter of the Bicycle class from a file. If we need to perform 
more than a simple assignment to initialize a class variable, then we define a static 
initializer. A static initializer is a code that gets executed when a class is loaded into 
thejava system. It is defined in the following manner: 

class XYZ { 


static { 

II code to initialize 

II class variables and perform 

//other tasks 


} 


} 

As an illustration, here's how we define the static initializer for the Bicycle class to 
set the starting value of counter to ioi: 

class Bicycle { 

private static int counter; 

static { 

counter = 101; 

} 

} 

We conclude this section with important reminders. 
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( Things to Remember 

1. Class methods can access only the class variables and the class constants of 
the class. 

2 . Instance methods, including constructors, can access all types of data members. 

3. Class methods cannot call instance methods of the same class. 

4. Instance methods can call all other methods of the same class. 


7.5 Call-by-Value Parameter Passing 

We will provide more detailed coverage on how arguments are passed to a method. 
Let's first review some key facts. Local variables are used for temporary purposes, 
such as storing intermediate results of a computation. While the data members of a 
class are accessible from all instance methods of the class, local variables and para¬ 
meters are accessible only from the method in which they are declared, and they are 
available only while the method is being executed. M emory space for local vari¬ 
ables and parameters is allocated upon declaration and at the beginning of the 
method, respectively, and erased upon exiting from the method. 

When a method is called, the value of the argument is passed to the matching 
parameter, and separate memory space is allocated to store this value. This way of 
passing the value of arguments is called a pass-by-value or call-by-value scheme. 
Since separate memory space is allocated for each parameter during the execution 
of the method, the parameter is local to the method, and therefore changes made to 
the parameter will not affect the value of the corresponding argument. 

Consider the following myMethod method of the Tester class. The method 
does not do anything meaningful. We use it hereto illustrate how the call-by-value 
scheme works. 

class Tester { 

public void myMet hod( i nt one, double two ) { 

one = 25; 
two = 3 5.4; 

} 

} 

What will be the output from the following code? 

Tester tester; 

i nt x , y ; 

tester = new Tester)); 

x = 10; 

y = 20; 

tester, my Method) x, y ); 

System, out. println) x + " 11 + y ) ; 
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The output will be 


1 0 2 0 I 

because with the pass-by-value scheme, the values of arguments are passed to the 
parameters, but changes made to the parameters are not passed back to the argu¬ 
ments. Figure 7.6 shows how the pass-by-value scheme works. 

Notice that the arguments are matched against the parameters in the I eft-to¬ 
ri ght order; that is, the value of the leftmost argument is passed to the leftmost pa¬ 
rameter, the value of the second-leftmost argument is passed to the second-leftmost 
parameter, and so forth. The number of arguments in the method call must match 
the number of parameters in the method definition. For example, the following calls 
to myMethod of the Tester class are all invalid because the number of arguments 
and number of parameters do not match. 

tester. myMethodl 12 ) ; 
tester, my Met hod( x, y, 24,5); 

Since we are assigning the value of an argument to the matching parameter, 
the data type of an argument must be assignment-compatible with the data type of 
the matchi ng parameter. For example, we can pass an i nteger argument to a float pa¬ 
rameter, butnotviceversa. In the fol lowi ng, the first call isvalid, but the second one 
is invalid: 

tester. myMethodl 12, 25 ); 
tester. myMethodl 23.0, 34,5 ); 

The name of the parameter and the name of the argument can be the same. 
Keep in mind, however, that the values of arguments are still passed to a method by 
the pass-by-value scheme; that is, local copies are made whether the argument and 
the parameter share the same name or not. 


I Things to Remember 

Remember these key points about arguments and parameters: 

1. Arguments are passed to a method by using the pass-by- value scheme. 

2. Arguments are matched to the parameters from left to right. The data type 
of an argument must be assignment-compatible with the data type of the 
matching parameter. 

3. The number of arguments in the method call must match the number of 
parameters in the method definition. 

4. Parameters and arguments do not have to have the same name. 

5. Local copies, which are distinct from arguments, are created even if the 
parameters and arguments share the same name. 

6. Parameters are input to a method, and they are local to the method. Changes 
made to the parameters will not affect the value of corresponding arguments. 
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1 


X = 10; 

y = 20; 

tester .myMethod! x, 



execution flow 

y ); 


at (?) before calling myMethod 



state of memory 


public void myMethod! i nt one, double two ) { 

one = 25; 
two = 35.4; 

} 


Local variables do not exist 
before the method execution. 


X = 10; 

y = 20; 

tester ,myMethod( x, y ); 


values are copied at (?) 



-- 

- 

x | 10 1 


one | 10 


_ 

- 

y 1 20 1' 


two" | 20.0 



public void myMethod! i nt one, double two ) 


{ 


© 


one = 25; 
two = 35.4; 


Memory space for myMethod is allocated, and the values 
of arguments are copied to the parameters. 


3 

X = 10; 

y = 20; 

tester .myMethod( x, y ); 


at (?) before return 





public void myMethod! i nt one, double two ) 


one 

@ two 


= 25; 

= 35.4; 


} 


{ 


The values of parameters are 
changed. 


X = 10; 

y = 20 ; 

tester .myMethod! x, y ); 

® 

at (?) after myMethod 




public void myMethod! i nt one, double two ) { 

one = 25; 
two = 35.4; 

> 


Memory space for myMethod is deallocated, and 
parameters are erased. Arguments are unchanged. 


Figure 7.6 How memory space for the parameters is allocated and deallocated. 
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Now let's look at a similar example again, but this time with objects. Consider 
the following class: 

class Obj ec t Tes t e r { 

public void swap(Fracti on f1, Fraction f 2 ) { 

Fraction t e mp; 

temp = fl; //swap the two fractions 

f 1 = f 2; 

f 2 = t e mp; 

} 

} 

What will be the output from the following code? 

ObjectTester tester; 

Fraction x, y; 

tester = new Obj ect Test er () ; 

x = new Fr acti on( 1, 2); 

y = new F r a c ti o n ( 3, 4); 

t est er. swap ( x, y) ; 

System, out. pri ntl n("x = " + x.toStri ng()); 

System, out. pri ntl n("y = " + y.toStri ng()); 

The output will be 


x = 1/ 2 
y = 3/4 

because the changes made to the parameters are not passed back to the arguments. 
It does not matter whether we are passing primitive data values or objects (actually, 
references to the objects). Figure 7.7 shows the effect of calling the swap method. 

Changes made to the parameters are not passed back to the arguments, but 
when we are passing objects to a method, then the changes made to the object itself 
are reflected back to the caller because the calling side still has the same reference 
to the object. Let's look at an example. Consider the following class: 

class Obj ec t Tes t e r 2 { 

public void chan ge ( Fr ac tio n fl) { 
f1. s e t N u me rator(lO); 

} 

} 
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At the beginning of 
the swap method. 



: Fraction 

numerator 
1 3 [ 

denominator 

■ I 


: Fraction 

numerator 
| 1 [ 
denominator 


At the end of the swap 
method when fl and 
f2 are swapped. 



After the swap method 
terminates. No changes 
made to parameters fl 
and f2 are reflected 
back to the arguments. 
Both x and y still point 
to the same objects as 
before the call. 



Figure 7.7 This illustration shows the effect of calling the swap method. 
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What will be the output from the foil owing code? 

Obj ectTester2 tester; 

Fraction x; 

tester = new Obj ect Test er () ; 

x = new F r a c t i o n ( 1, 2); 

tester, change(x); 

System, out. pri ntl n("x = " + x.toStri ng()); 

The output will be 


x = 10/2 


Figure 7.8 shows the effect of calling the change method. N otice that the variable x 
continues to point to the same object, but the object itself has been modified. 


C\\ou 

D Might 
Want to 

Know 


Pass-by-value (also known as call-by-value) is the only parameter passing mech¬ 
anism Java supports. Because we are passing references when objects are passed 
to methods, many people with background in other programming languages 
use the term pass by reference (or call by reference) when referring to the passing 
of objects to methods. This is wrong. Pass by reference means an address (or ref¬ 
erence) of a variable is passed, whereas pass by value means the content of a 
variable is passed (and copied into a parameter). In Java, the content of a variable 
is either a value of primitive data type or a reference to an object (this is the 
source of confusion). But it doesn't matter what the content of a variable is; as 
long as the content of a variable is passed and copied into a parameter, it is a 
call by value. If a programming language supports the pass-by-reference 
mechanism, then it is possible, for example, to swap the values of two arguments 
in a single method call. No such thing is possible in Java. 


W 

1. What is the name of the scheme used in Java to pass arguments to a method? 

2. W hat is the output from the following code? 

class Quest i on { 
private int one; 

public void my Me t h o d ( int one ) { 
this.one = one; 
one = 12; 

} 

} 


Quick 

CHECK 
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At the beginning of 
the change method. 



: Fraction 

numerator 
| 1 1 

denominator 

I 2 I 


At the end of the 
change method when 
the numerator of the 
Fraction object is 
changed. 



A fter the change 
method terminates. 
The variable x still 
points to the same 
object, but the object 
itself has been 
modified. 



■ _ 

Fraction 


numerator 
1 10 

denominator 

I 2 I 



Figure 7.8 This illustration shows the effect of calling the change method. 
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programmer- 

defined 

packages 


7.6 


Organizing Classes into a Package 


For simplicity, we have placed all programmer-defined classes of a program in the 
same folder since Chapter 4. This approach works fine while we are learning pro¬ 
gramming and do not deal with many classes. But in a more real-life context, we 
need to manage classes more effectively. For example, following the approach, we 
have to copy the Fraction class to multiple folders if we want to use this class in dif¬ 
ferent programs. 

The correct approach to reusing programmer-defined classes is to organize 
them into packages, just as the standard classes are organized into packages. We 
illustrate the process by using the Fraction class. Let's name the package to pi ace the 
Fraction class myutil. It is a J ava convention to name the package with all low¬ 
ercase letters. Once this package is set up correctly, we can use the classes in the 
package by importing it, just as we have been doing with the standard packages. 


i mp o r t my u t i I . *; 

class MyCIi ent { 
Fraction f 1; 


} 

To set up the programmer-defined packages for general reuse, not just use by 
the programs in the same folder, we have to perform the following tasks: 

1. Include the statement 

package myutil; 

as the first statement of the source file for the Fraction class. 

2. The class declaration must include the visibility modifier public as 

public class Fraction { 

} 

3. Create a folder named myutil, the same name as the package name. In Java, 
the package must have a one-to-one correspondence with the folder. 

4. Place the modified Fraction class into the myutil folder and compile it. 

5. M odify the classpath environment variable to include the folder that 
contains the myutil folder. See below. 

Step 5 is the most troublesome step for those new to Java. Since the exact 
steps to change the classpath environment variable are different from each 
platform (Windows, Unix, M ac) and Java IDE (Eclipse, NetBeans, jGRASP, BlueJ, 
etc.), we will describe only the general idea for the Windows platform here. 
Suppose we have a folder named JavaPrograms under the C: drive, and the myutil 
package (folder) is placed inside this JavaPrograms folder. Then to use the cl asses in 
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the myutil package, the classpath environment should make a reference to the 
JavaPrograms folder (not to the package myutil itself): 

set cl asspath=,; c:\J avaPrograms 

The period after the equals symbol refers to the current folder (the folder where the 
client program we are trying to execute is located). Without this reference to the cur¬ 
rent folder, the client program will not recognize other classes in the same folder. 


ings to Remember 

To make the programmer-defined packages accessible to all client programs, the 
CLASSPATH environment variable must be set up correctly. 


7.7 Using Javadoc Comments for Class Documentation 

We mentioned in Chapter 2 that there are three styles of comments in Java. We have 
been using the two of them. We introduce the third style cal led javadoc comments in 
this section. M any of the programmer-defined classes we design are intended to be 
used by other programmers. It is, therefore, very important to provide meaningful 
documentation to the client programmers so they can understand how to use our 
classes correctly. By adding javadoc comments to the classes we design, we can 
provide a consistent style of documenting the classes. Once the javadoc comments 
are added to a class, we can use a special program (comes as a part of Java 2 SDK) 
to generate HTM L files for documentation. (Note: An HTM L file is a specially 
marked file intended for a Web browser.) We mentioned in Chapter 2 that the docu¬ 
mentation for the standard classes can be found at http://javasiti.com/ja\/a>e/6/ 
docs/api/. 

This documentation is derived from the javadoc comments embedded in the 
standard classes. 

We wi 11 descri be how to usej avadoc comments and generate the correspondi ng- 
HT M L documentation fiIes. B efore we get i nto the detaiIs, wefirst show the end result 
so you can visualize where the process is leading. Figure 7.9 shows a portion of the 
HTML documentati on for the Fraction class displayed in a browser. 

A javadoc comment is used as header comment for a class, a data member, or 
a method. Let's begin with the class header comment for the Fraction class in the 
javadoc format: 

I * * 

* An instance of this class represents a fraction. 

* 

* @a u t h o r Dr, Caffeine 

* 

*1 

class Fraction { 

} 
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40 Fraction - Microsoft Internet Explorer 

- IS 

j File Edit View Favorites 

Tools Help 


o - o a a «> 

P i? « 48 

• & H - D □ A <9 4 


All Classes 

Fraction 


Package Q^Tree Deprecated Index Help 


PREV CLASS NEXT CLASS 

SUMMARY: NESTED | FIELD | CONSTR | METHOD 


FRAMES NO FRAMES 

DETAIL: FIELD | CONSTR | METHOD 


myutil 

Class Fraction 


j ava.lang.Obj ect 
I—myutil. Fraction 


public class Fraction 
extends java.lang. Object 

An instance of this class represents a fraction. 


Field Summary 

denominator 


the denominator of this fraction 
nnmerator 


the numerator of this fraction 


Constructor Summary 


Fraction ( ) 

Creates a fraction 0/1 


Fraction ( Fraction frac) 
Creates a copy of frac 


Fraction (int number) 


0 


J S 


Figure 7.9 A browser showing the HTML documentation file derived from the javadoc comments for the 
Fraction class. 


javadoc tags 

@authortag 


The javadoc comments begin with the marker /** and end with the marker */. The 
asterisks on the lines between the first and the last markers have no significance; 
they are there to provide a visual aid to highlight the comments in the program. 
It is an accepted standard to use the asterisks in this manner for the javadoc 
comments. 

Inside the javadoc comments, we can use a number of javadoc tags, special 
markers that begin with the @ mark. In this example, we see one javadoc tag 
@author, which we use to list the authors of the class. 
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@paramtag 


@return tag 


Here's how we comment a data member in javadoc: 

I * * 

* The numerator portion of this fraction 

*/ 

private int numerator; 

W hen the length of a comment is short and fits i n a si ngle I i ne, then we can write the 
javadoc comment as 

/ * * The numerator portion of this fraction * / 

private int numerator; 

The javadoc comment for a method is similar to the one for the class header 
comment. It will include a number of javadoc tags in addition to a general descrip¬ 
tion. Here's how a method is commented by using javadoc: 


I * * 

* Returns the sumof this Fraction 

* and the para me ter frac. The sum 

* returned is NOT simplified, 

* 

* @p a r a m frac the Fraction to add to this 

* Fraction 

* 

* @r e t u r n the sumof this and frac 

*1 


public Fraction add(Fracti on frac) { 


} 


The purpose of the method header comment is to record the method's pur¬ 
pose, list of parameters passed to the method, and value returned from the method. 
This method receives one parameter, so there is one @param tag. We attach a short 
description of the parameter in addition to the parameter's name. The syntax for the 
@param javadoc tag is 

@param parameter name> <description> 

The <description> portion can go beyond one line. As this method returns a value, 
we add the @ return tag. Its syntax is 

@r e t u r n <description> 

A javadoc comment for a constructor is defined in a manner similar to the 
one for a method, except there will never be an @ return tag for a constructor. 
Figure 7.10 shows the HTML document that is generated from this javadoc com¬ 
ment. N otice the effect of @ param and @ return tags. 
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Figure 7.10 The portion of the HTML documentation file that is derived from the javadoc header comment 
for the add method. 


The use of the javadoc comments does not preclude the use of other types of 
comments. We still need to use regular comments to describe the code as necessary. 
For example, we will continue to include the group comment for methods, as in 


//- 



// 

Public Methods: 


// 



// 

Fraction add 

( Fraction ) 

// 

Fraction add 

( int ) 

// 



// 



//- 




so that programmers reading the class will have a handy reference to the list of 
methods without referring to any online documentation. This is especially useful 
when the programmers are reading a hard copy of the class source file. Notice that 
we don't use the javadoc style for a quick reference list because javadoc comments 
are used only for describing the class and its data members and methods. 

Once all thejavadoc comments are added to a class, we are ready to generate 
the corresponding HTM L documentation file. For easy reference, we call it the 
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javadoc file. M any J ava editors and IDEs include a menu option that you can use 
to generate javadoc files easily and quickly. Here we describe the steps you can 
take to generate javadoc files using the minimalist approach (see App. A). In the 
command prompt window, we used the commands javac and java to compile and 
run Java programs, respectively. Similarly, to generate javadoc files, we use the 
javadoc command. For example, to generate a javadoc file for the Fraction class, 
we enter 


javadoc -private Fr acti on.j ava 

We specify the -private option because we want to generate the documentation for 
all types of methods (so far, we have covered two of these— private and public). The 
-private option generates the most complete documentation. W hen the command is 
executed, status messages such as these are displayed. 


Q1 C:\WINDOWS\System32\cmd.exe 


Jnjxj 


N:\Pi s ograms\CSlED4SamplePi'ogi'ams\Chapter7>javadoc -private Fraction .java 
Loading source file Fraction.java... 

■Constructing Javadoc information... 

■Standard Doclet version 1.4.2_03 
^Generating constant-values.html... 

Building tree for all the packages and classes... 

Building index for all the packages and classes... 

Generating overview-tree.html... 

[Generating index-all.html... 

Generating deprecated-list.html... 

Building index for all classes... 

JGenerating allclasses-frame.html... 

■Generating allclasses-noframe.html... 

■Generating index.html... 

■Generating packages.html... 

IGenerating Fraction.html... 

Generating package-list... 

Generating help-doc.html... 

Generating stylesheet.css... 


|N:\Programs\CSlED4SamplePrograms\Chapter7>_ 


A fter the command i s executed successful ly, there will actual ly be a col I ecti on 
of HTM L files, not just the expected Fraction.html. You can view the content shown 
in Figure 7.9 by opening the file index.html and clicking the Fraction link. Open the 
Fraction.html directly from your browser and see the difference. We encourage you 
to open other HTML files to see how these files are related. The generated HTML 
files are located in the same directory where the source file Fraction.java is located. 
You can change the directory by setting the -d option and specifying the directory 
to store the generated HTM L files (alternatively, you can move the files using an op¬ 
erating system's file manager). We ordinarily do not generate javadoc files one cl ass 
at a time. Rather, it is more common to generate a complete set of javadoc files for 
all classes in a single package at once, as in 

javadoc -private *.j ava 

We will refer you to websites for a more complete discussion of javadoc. 
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|}ings to Remember 

General information on javadoc is located at 

http://java.sun.com/j2se/javadoc/ 

Detailed reference on how to use javadoc on Windows is located at 

http://java.sun.eom/javase/6/docs/technotes/tools/windows/javadoc.html 



Is it really important to use javadoc comments? It's true that we have to learn a few 
extra items to use javadoc comments, but the benefits warrant a little extra effort. 
First, by using javadoc comments, we can easily produce the standard online 
documentation. Even if we don't have an immediate need to produce an online 
documentation, we can use javadoc comments because they are really not that 
different from other styles of commenting, and their use gives us an option to 
produce an online documentation later. Second, since javadoc is a standard, other 
programmers will have an easier time reading your code with javadoc comments 
than reading code with a nonstandard style of comments. 
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1. Add javadoc comments to the following class. 
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2. W hat is the purpose of @author tag? 


7.8 The Complete Fraction Class 

In this section, we will list a complete definition for the myutil.Fraction class. In the 
final version of the class, we will include improvements to one of the constructors 
and the simplify method. Earlier in the chapter, we presented the fourth constructor 
as follows: 

public Fracti on(i nt niim, int denom) { 

setNumerator(num); 
set Denomi nator(denom); 

} 
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For this constructor to function properly, we made an assumption that the values 
for both parameters are nonnegative. Let's remove this assumption and make the 
necessary modifications to the constructor. 

Consider the following two statements: 

Fraction fl = new Fracti on(-2, 9); 

Fraction f 2 = new Fracti on(2, -9); 

2 

Both represent the same value, namely,-—. With thegiven constructor, fi will have 

the values -2 and 9 for its data members numerator and denominator, respectively. 
A nd f2 will have the values 2 and -9 for its data members numerator and denom¬ 
inator, respectively. This means that we have two distinct ways to represent the 
same value. It is always preferable to maintain a consistent representation because 
multiple representations for the same value would lead to a more complex code for 
handling different representations correctly. We will improve this constructor so 
that a negative fraction is always represented by a negative value for numerator and 
a positive value for denominator. 

Now, consider the following two statements: 

Fraction f 3 = new Fracti on(2, 9); 

Fraction f4 = new Fracti on(-2, -9); 

2 

Both objects represent the same positive fraction —.Again, to maintain consistent 

representation, a positive fraction is always represented by positive values for both 
numerator and denominator. 

Finally, consider the following two statements: 

Fraction f 3 = new Fracti on(0, 9); 

Fraction f 4 = new Fracti on(0, -5); 

Both objects represent the numerical value of 0. We will always represent the numer¬ 
ical value of 0 by storing 0 in the data member numerator and 1 in denominator. 

FI ere's the modified constructor: 

public Fraction(int num, int denom) { 

if ( denom < 0) { 
num = -num; 
denom = - denom; 

} 

if ( num == 0) { 
denom = 1; 

} 

set Numerator! num) ; 
set De no mi nator(denom); 

} 
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We will also make a modification to the simplify method. The original simplify 
method fails when someone tries to simplify a zero fraction (i.e., a fraction with 
numerical value of 0). To reduce a fraction to its simplified form, we find the 
greatest common divisor of its numerator and denominator and divide them by 
the greatest common divisor. W hat happens when the numerator is 0? The greatest 
common divisor of 0 and any other value is 0. So we would end up dividing the nu¬ 
merator and denominator by 0! Here's the new simplify method that avoids this 
problem: 


1 i c 

Fraction s i mp 1 i f y ( ) { 


i nt 

num = getNumerator(); 


i nt 

denom = getDenominatorf); 


i nt 

divisor = 1; 


if 1 

i num ! = 0) { 


< 

} 

fivisor = gcd(Math,abs(num), 

denom); 

return new Fractionfnum/divisor, 

denom/di vi sor 


} 


package my util; 

I * * * 

* An instance of this class represents a fraction, 

* 

* 

*1 

public class Fraction { 

/ * * the numerator of this fraction * / 

private int numerator; 

/** the denominator of this fraction */ 

private int denominator; 


' \ 

Data Members 


II . 

II Constructors 


I * * 

* Creates a fraction 0/1 

*1 

public Fraction! ) { 
t hi s( 0, 1); 

} 


Constructors 
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I * * 

* Creates a fraction number/1 

* 

* @p a r a m n u mb e r the numerator 

*/ 

public Fracti on(i nt number) { 
thi s(number, 1); 

} 

I * * 

* Creates a copy of f r ac 

* 

* @param frac a copy of this para me ter is created 

*/ 

public Fracti on(Fracti on frac) { 

thi s(frac. get Numerator! ), frac. getDenomi nator()); 

} 

I * * 

* Creates a fraction num/denom. Create a negative 

* fraction as -numand denom. If negative values 

* are specified for both numand denom, the fraction 

* is converted to a positive. If num i s positive and 

* denom is negative, the fraction will be converted to 

* have negative num and positive denom. 

* When the num is zero, denom is set to 1. Zero is 

* always represented as 0/1 

* 

* @p a r a m n u m the numerator 

* @param denom the denominator 

*/ 

public Fracti on(i nt num, int denom) { 

if ( denom < 0) { 
num = -num; 
denom = - denom; 

} 

if ( num == 0) { 
denom = 1; 

} 

setNumerator(num); 
set Denomi nator(denom); 


II . 

II Class Met hods 
II 

II . 
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I * * 

* Returns the greatest common divisor of 

* the parameters mand n 

* 

* @p a r a m m t h e first number 

* @p a r a m n the second number 

* 

* @r e t u r n the greatest co mmo n divisor of mand n 
*/ - 

public static int gcdfint m, int n) { gcd 


i nt r = n % m; 
whi I e (r ! =0) { 

n = m; 
m = r; 
r = n % m; 


} 

return m; 


} 


I * * 

* Returns the smaller of the two parameters fl and f2 

* 

* @p a r a m f1 the first fraction to compare 

* @p a r a m f 2 the second fraction to compare 

* 

* @return the smaller of the two parameters 

*/ 

public static Fraction mi nfFracti on fl, Fraction f 2 ) { 

//convert to decimals and then compare 

double f 1 _dec = fl.decimalf); 
double f 2 _ d e c = f 2,d e c i ma I () ; 


( 'v 

min 


if ( f 1 _ d e c <= f 2 _ d e c ) { 


return f 1; 


} else { 

return f 2; 


} 


} 
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II . 

II Public Instance Methods 
II 

II . 


I * * 

* Returns the sumof this Fraction 

* and the para me ter frac. The sum 

* returned is NOT s i mp I i f i ed, 

* 

* @param frac the Fraction to add to this 

* Fraction 

* 

* @r e t u r n the sumof this and frac 
*1 

public Fraction addfFracti on frac) { 
i nt a, b, c, d; 

Fraction sum; 

a = thi s. getNumeratorf); 
b = thi s. getDenomi natorf) ; 
c = frac. getNumeratorf); 
d = frac. getDenomi natorf); 

sum = new Fracti on(a*d + b*c, b * d ); 

return sum; 

} 

I * * 

* Returns the sumof this Fraction 

* and the int para me ter number. The sum 

* returned is NOT s i mp I i f i e d. 

* 

* @p a r a m number the integer to add to this 

* Fraction 

* @r e t u r n the sumof this Fraction and number 
*1 

public Fraction addfint number) { 

Fraction frac = new Fracti onfnumber, 1); 
Fraction sum = add(frac); 
return sum; 




} 
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I * * 

* Returns the quotient of this Fraction 

* divided by the para me ter frac. The quotient 

* returned is NOT s i mp I i f i ed, 

* 

* @param frac the divisor of the division 

* 

* @r e t u r n the quotient of this fraction 

* dividedbyfrac 

*/ 

public Fraction di vi de ( Fracti on frac) { 
i nt a, b, c, d; 

Fraction quotient; 

a = thi s. getNumeratorf); 
b = thi s. getDenomi nator() ; 
c = frac. getNumeratorf); 
d = frac. getDenomi nator(); 

quotient = new Fracti on ( a *d, b * c ); 

return quotient; 

} 



I * * 

* Returns the quotient of this Fraction 

* divided by the int parameter number. The quotient 

* returned is NOT s i mp I i f i ed, 

* 


* @p a r a m number the divisor 

* 

* @r e t u r n the quotient of this Fraction 
*/ 

public Fraction dividefint number) { 

Fraction frac = new Fracti onfnumber, 


divided by number 


1 ); 


divide 


Fraction quotient = divide(frac); 


return quotient; 

} 


I * * 

* Compares this fraction and the parameter frac for 

* equality. This method compares the two by first 

* reducing them to the simplest form. 

* 

* @param frac the fraction object to compare 

* 

* @r e t u r n true if this Fraction object and frac are equal 

*/ 
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public boolean equal sfFracti on frac) { 

Fraction fl = simplify)); //simplify itself 
Fraction f 2 = frac. si mpl i fy(); //simplify frac 


L 


equals 


} 


return (fl. getNu me r a t o r () == f2,getNumerator() && 

f 1. get Denomi nat or () == f 2. get Denomi nat or ( )) ; 


I * * 

* Returns the denominator of this fraction 

* 

* @r e t u r n the denominator of this fraction 


public int getDenomi nator( ) { getDenominator 

return denominator; 

} 

I * * 


* Returns 

* 

t he 

n u me r a t o r 

of 

this 

f r acti on 

* @r e t u r n 

t he 

n u me r a t o r 

of 

this 

f r acti on 


public int get Numer at or ( ) { getNumerator 

return numerator; 

} 


I * * 

* Returns the product of this Fraction 

* and the para me ter frac. The product 

* returned is NOT simplified. 

* 

* @param frac the multiplier of the multiplication 

* 

* @r e t u r n the product of this fraction 

* and the para me ter frac 

*/ 

public Fraction multiply(Fraction frac) { 
int a , b, c , d ; 


multiply 


Fraction product; 

a = this. getNu me r a t o r ( ) ; 
b = this.getDenomi nator(); 

c = frac.getNume ratorf); 
d = frac.getDenomi nator(); 

product = new Fracti on ( a *c, b * d ); 

return product; 

} 
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I * * 

* Returns the product of this Fraction 

* and the int para me ter number. The product 

* returned is NOT s i mp I i f i ed, 

* 

* @p a r a m n u mb e r the multiplier 

* 

* @r e t u r n the product of this Fraction and number 

*/ 

public Fraction multiply! int number) { 

Fraction frac = new Fracti onfnumber, 1); 
Fraction product = multiply(frac); 
return product; 

} 

I * * 

* Sets the denominator of this fraction 

* 

* @param denom the denominator of this fraction 

*/ 

public void set Denomi natorf i nt denom) { 
if (denom == 0) { 

//Fatal error 

System, out. pri ntl n ( " Fatal Error 11 ); 

System, exit(l); 

} 

denominator = denom; 


I * * 

* Sets the numerator of this fraction 

* 

* @paramnumthe numerator of this fraction 

*/ 

public void set Numerator( i nt num) { 
numerator = num; 

} 

I * * 

* Returns a new Fraction object that is in 

* the simplest form of this Fraction object. If 

* this Fraction is zero, then a simple copy of 

* it is returned. 

* 

* @return a Fraction object in the simplest form 

* of this Fraction 
*/ 


multiply 


setDe 


setDenominator 


■\ 


-Jr 


setNumerator 


www.it-ebooks.info 
















7.8 The Complete Fraction Class 417 


public Fraction simplify! ) { 

int num = getNumerator(); 
i nt denom = get Denomi nat or ( ) ; 

int divisor = 1; 

if ( num ! = 0) { 

divisor = gcd(Math.abs(num), denom); 

} 

return new Fracti on(num/ divisor, denom/ divisor); 

} 

I * * 

* Returns the difference of this Fraction 

* and the para me ter frac. The difference 

* returned is NOT simplified, 

* 

* @p a r a m frac the Fraction to subtract from 

* this Fraction 

* 

* @r e t u r n the difference of this and frac 

*/ 

public Fraction subtract ( Fracti on frac) { 
int a, b, c, d; 

Fraction diff; 

a = this. getNumerator(); 
b = this.getDenomi nator(); 
c = frac.getNumerator(); 
d = frac. get Denomi nator( ) ; 

diff = new Fracti on(a*d - b * c, b*d); 

return diff; 

} 

I * * 

* Returns the difference of this Fraction 

* and the int parameter number. The difference 

* returned is NOT simplified. 

* 

* @p a r a m number the int value to subtract 

* 

* @r e t u r n the difference of this and number 

*/ 

public Fraction subtract(int number) { 

Fraction frac = new Fracti onfnumber, 1); 
Fraction difference = subtract ( frac ) ; 
return difference; 

} 


simplify 


c 


subtract 


4 


f > 

subtract 
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I * * 

* Returns the String representation of this Fraction 

* 

* @r e t u r n the String representation of this Fraction 


public String toStringl ) { tostring 

return getNumeratorf) + "/" + get Denominator!); 

} 

II 

II Private Methods 

II 

II 


II * * 

* Returns the decimal equivalent of this fraction 

* 

* @r e t u r n the decimal equivalent of this fraction 
*1 

private double decimal! ) { 

//returns the decimal equivalent 

return (double) getNumerator!) / get Denominator!); 

} 

} 


decimal 


■> 


7.9 Sample Development 


Library Overdue Checker 

How many library books are lying around in your room waiting to be returned? How 
much have you accrued in late charges on those overdue books? Let's write a program 
that computes the total charges for overdue library books. The program allows you to 
input the title, overdue charge per day, maximum possible charge, and due date for each 
book you enter. The due date is the only required input. The other three input values are 
optional, and when they are not provided, preset default values are used by the program. 
We assume that an upper limit is set for overdue charges, so your charge will not increase 
beyond this limit.This limit is entered as the maximum possible charge. For example, a 
library may set $1.50 as the overdue charge per day and $30 as the maximum overdue 
charge for a single overdue book. We enter the overdue charge per day and the maxi¬ 
mum overdue charge for every book, because depending on the types of books, they 
could be different. For example,a charge for books with a 3-day loan period may be much 
higher than for books with a regular 2-week loan period. 

After you enter information for all books, the program displays the entered book 
data. Then the program will allow you to enter different return dates. For each return date 
you enter, the program will display the total overdue charges. Being able to enter different 
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program 

tasks 


return dates will let you make an informed decision, such as "I'll wait till tomorrow since it's 
raining heavily today and it costs only $2 more if I return them tomorrow." (We always 
encourage you to return library books promptly for the sake of fellow library users.) 

A better program will warn you when there's a looming due date so you won't end 
up paying the overdue charges. We will discuss this and other possible extensions at the 
end of this section. All the possible extensions we will discuss require techniques yet to 
be studied. The program we develop here is implemented by the techniques we have 
already mastered and by using one simple helper class. 

Problem Statement 

Write an application that computes the total charges for the overdue library 
books. For each library book, the user enters the due date and (optionally) the 
overdue charge per day, the maximum charge, and the title. If the optional values 
are not entered, then the preset default values are used. A complete list of book 
information is displayed when the user finishes entering the input data. The user 
can enter different return dates to compare the overdue charges. 

Overall Plan 

As always, we begin our overall plan for the development with the outline of program 
logic. We first let the user enter the information on all books. After finishing the book data 
entry, we display them as a list.Then we ask repeatedly for return dates. For each return 
date entered, we provide the total overdue charge. We express the program flow as hav¬ 
ing three tasks: 

1. Get the information for all books. 

2. Display the entered book data. 

3. Ask for the return date and display the total charge. Repeat this step until the user 
quits. 

Let's look at each task and determine objects required for handling the task. The 
first step sounds simple enough, but it hides the complexity of the whole program. It 
indicates the need for at least three types of objects. One is to carry out the actual input 
routines, another is to retain four pieces of information for each book, and yet another is 
to keep track of multiple books entered by the user. Notice that there's no limit on the 
number of books the user can enter, because putting such a limit will reduce the usability 
of the program. This means we need a class to manage a collection of book information. 
We have not yet learned how to manage a collection of objects (Chap. 10 covers the 
topic), so we will use the helper class named BookTracker. This class is actually very 
straightforward,once we learn the relevant topic. The class is written generically and does 
not contain any application-specific logic. 

We will define a class named LibraryBookthat keeps track of book information. An 
instance of this class represents a single library book.The LibraryBook class is the key 
"work horse" in this program. A LibraryBook object keeps track of four pieces of infor¬ 
mation and is responsible for computing the overdue charge. Notice that the class is the 
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most appropriate place to perform the computation of the overdue charge because it is 
where all pieces of information necessary to compute the charge are stored. 

We will define another class for performing the actual input routines. An instance of 
this class will input the data, create a LibraryBook object with the input data, and add this 
object to a BookTracker. As it uses other objects, it will be the main controller of the pro¬ 
gram. We will name the class OverdueChecker. We will define it as an instantiable main 
class. For this program, we will use console input.lt is a straightforward exercise to modify 
the OverdueChecker class to handle input by using JOptionPane or other types of GUI. 

Now let's study the second task of displaying the entered book data. To be 
consistent with the console input, we will use console output. An OverdueChecker will 
handle the output, but the data to display come from a BookTracker, as it is the one 
maintaining the collection of LibraryBook objects. The BookTracker class has one 
method called getBookList. This method returns the book list as a single String value. 
The OverdueChecker displays the returned string on the standard output window. 
Notice that the BookTracker class is not programmed to do the output directly, because 
doing so will reduce its usability. By returning the book list as a String datum, the client of 
the Book-Tracker class retains the option of using either console output or GUI. This 
helps to keep the flexibility and increases the usability of a class. 

For the last task, an OverdueChecker interacts with the user to get the return 
dates. For each return date entered, it asks BookTracker for the total charge and dis¬ 
plays the returned value.The BookTracker in turn asks individual LibraryBook objects 
for their charges by calling the computeCharge method and computes the sum. This is 
the reason why we must include the method named computeCharge in the 
LibraryBook class that computes the overdue charge for a single book. We will discuss 
the details of this and other requirements in defining the LibraryBook class shortly. 

Flere's our working design document: 


program 

classes 


Design Document: Library Ov erdueChecker 


Class 


Purpose 


Over dueChecke 


e r The top-level control object that manages other objects 


Scanner 


BookTracker 


Li br ar yBook 


in the prog ram. This is an instantiable main class, as 
explained in Section 4.10. 

The predefined helper class that keeps track of library 
books. 

An instance of this class represents a single library book. 
A library book for this program has four properties— 
title, charge per day, maximum charge, and due date. It is 
also responsible for computing the overdue charges. 
The standard class for handling input routines. 
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Figure 7.11 The program diagram for the OverdueChecker program. We will implement the 
OverdueChecker and LibraryBook classes.The Scanner class is the standard class for console input, 
and the BookTracker class is the helper class provided for this program. 


develop¬ 
ment steps 


Figure 7.11 is the program diagram for this program. 

We will implement this program in the following five major steps: 

1. Define the basic LibraryBook class. Use a test main class to confirm the 
implementation of the LibraryBook class. 

2. Explore the given BookTracker class and integrate it with the LibraryBook class. 
Modify or extend the LibraryBook class as necessary. 

3. Define the top-level OverdueChecker class. Implement the complete input 
routines. Modify or extend the LibraryBook class as necessary. 

4. Complete the LibraryBook class by fully implementing the overdue charge 
computation. 

5. Finalize the program by tying up loose ends. 

Again, the development strategy we indicate here is one of the possible alterna¬ 
tives. We could start from the skeleton main controller class OverdueChecker, as we nor¬ 
mally did in the previous sample development examples. For this program, however, we 
start with the LibraryBook class because of its importance in the program. We want to 
start from the most important workhorse class. Also, before we implement any elaborate 
input and output routines, we need to know how the BookTracker class works, and to 
explore this helper class fully, we need the LibraryBook class. 


Step 1 Development: The Basic Li braryBook class 

step 1 We begin the development with the basic LibraryBook class. The main purpose in step 1 

design j s t0 start t h e ma j n workhorse class to establish the foundation for the development. 

Since this class is used by the BookTracker class, we need to find out the compatibility 
requirements so we won't define any methods that will violate the compatibility. There 
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are two methods used by the BookTracker class, so we need to define them in the Library- 
Book class. Here are the two required methods and their descriptions: 

Required Methods of Li braryBook 

public String t oSt ri ng( ) 

Returns the String representation of itself. This string is used by the BookTracker 
class to generate a complete book list. 

public double computeChargef Gregori anCal endar returnDate) 
Computes and returns the overdue charge for this book, given the return date. 


The key design task for this step is to identify the data members for storing relevant 
information and to define their accessors and mutators as appropriate. Also, we will de¬ 
sign multiple constructors so an instance of this class can be created in a flexible manner. 

We define data members for the four pieces of required information for each book 
as follows: 


private Gregori anCaI endar dueDate; 
private String title; 
private double chargePer Day; 
private double maximumCharge; 

For each of these data members, we will define the corresponding accessors and mutators. 

We define four constructors. Because the due date is something that must be 
assigned when a new LibraryBook is created, every constructor requires the due date as 
its argument. When other optional values are not passed to the constructor, then preset 
default values are assigned. We define the multiple constructors using the technique we 
learned in this chapter.The signatures for these constructors are as follows: 
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We won't be using the BookTracker class in this step, so we do not have to define 
the two required methods yet. However, we can use the toString method now to verify 
the correct operations of constructors and other methods, so we define it now. We use 
the formatting techniques learned in Section 6.8 to format the string we return from 
toString. Here's how we define the toString method: 

public String toString) ) { 
return String,for mat) 

" %- 3 0 s $ %5. 2 f $ %7. 2 f %4 $ t m/ %4 $ t d / %4 $ t y", 

g e t Ti11 e (), get Cha r gePer Da y () , 

get MaxChar ge( ), dueDate, getTi me ( )) ; 

} 

A sample string returned from the method will formatted in the following manner: 

Introduction to OOP with java $ 0.75 $ 5 0.0 0 0 7 / 1 0/ 0 6 

Alternatively, we can format the string by using the SimpleDateFormat and 
DecimalFormat classes. 

public String toString) ) { 

String tab = "\ t" ; 

SimpleDateFormat sdf 

= new Si mpl eDateFormat("MM/dd/yy"); 

D e c i ma I F o r ma t d f = new D e c i ma I F o r ma t (" 0. 00"); 

return getTitle)) + tab + 11 $ " + 

df.format(getChargePerDay))) + tab + " $ 11 + 
df. format(getMaxCharge) )) + tab + 
sdf. for mat (dueDate. getTi me))); 

} 

step 1 code We are now ready to implement the class. Here's the step 1 code (minus javadoc 

and most other comments): 


Chapter 7 Library Overdue Checker 
Step 1 LibraryBook class 
File: LibraryBook.java 
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import java,util.*; 
class Li braryBook { 

private static final 
private static final 
private static final 


double CHARGE_ PE R_DAY = 0.50; 
double MAX_CHARGE = 5 0.0 0; 
String DEFAULT_TITLE = "Title 


private Gr egori anCaI enda r d u e Da t e; 
private String title; 
private double chargePerDay; 


private double maximumCharge; 
public L i b rar yBook ( Greg or ianCa I endar dueDate) { 
t hi s( dueDat e, CHARGE PER DAY) ; 

} 

public Li braryBook ( GregorianCaI endar dueDate, 
double chargePerDay) { 

thi s(dueDate, chargePerDay, MAX_ C HARGE ); 

} 


public Li braryBook ( GregorianCaI endar dueDate, 
double chargePerDay, 
double maximumCharge) { 


} 


thi sjdueDate, chargePerDay, 

maximumCharge, DEFAULT_TI TLE) ; 


public L i b raryBook ( GregorianCaI endar dueDate, 
double chargePerDay, 
double maximumCharge, 
String title) { 


set DueDat e( dueDat e); 
setChargePerDay(chargePerDay); 
s e t Ma x i mu mC h a r g e ( ma x i mu mC h a r g e ) ; 
setTitle(title); 


public double get ChargePerD a y ( ) { 
return chargePerDay; 

} 


unknown" ; 
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public GregorianCalendar get DueDat e( ) { 
return d ue Da t e; 

} 

public double getMaxCharge( ) { 
return maxi mumChar ge; 

} 

publ ic String g e t T i 11 e ( ) { 
return title; 

} 

publ i c voi d setChargePerDay( doubl e c h a r g e ) { 
chargePerDay = charge; 

} 

publ i c voi d setDueDate(Gregori anCal endar date) { 
dueDat e = date; 

} 

publ i c voi d set Maxi mumCharge( doubl e c h a r g e ) { 
maximumCharge = charge; 

} 

publ i c voi d setTitle(String title) { 
thi s. t i 11 e = title; 

} 

publ ic String toStri ng( ) { 
return Stri ng. format( 

" %- 3 0 s $ %5. 2 f $ %7. 2 f %4 $ t m/ %4 $ t d / %4 $ t y" , 

getTitI e(), getChargePerDay (), 

get MaxChar ge(), dueDat e. getTi me()); 

} 

} 


The purpose of step 1 testing is to verify we can create LibraryBook objects using 
different constructors. In addition, we check that the other methods are working cor¬ 
rectly, especially the toString method. Here's one possible test main class: 



* 

Introduction to OOP with java 4th ed., 


Me Gr a w- Hi I I 


File: Stepl/SteplMai n.j ava 

*/ 
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import java,util.*; 
class SteplMain { 

public static void ma i n ( Stri ng[] a r gs ) { 

II Create three Li braryBook objects and output them 
GregorianCalendar due Date; 

Li braryBook bookl, book2, book3, book4; 

dueDate = new Gregori anCaI endar ( 2008, CaI endar. MARCH, 14); 
bookl = new Li braryBook(dueDate); 

dueDate = new Gregori anCaI endar ( 2008, CaI endar. FEBRUARY, 13); 
book2 = new Li braryBook ( dueDate, 0.75); 

book2. setTitl e(" Introduction to oop with Java"); 

dueDate = new Gregori anCaI endar ( 2008, CaI endar. j ANUARY, 12); 
book3 = new Li braryBook ( dueDate, 1.0 0, 1 0 0.0 0 ); 

b o o k 3. s e t T i 11 e (" j a v a for S ma r t i e s" ) ; 

dueDate = new Gregori anCaI endar ( 2008, CaI endar.jANUARY, 1); 
book4 = new Li br ar yBook ( dueDat e, 1.5 0, 2 3 0.0 0, 


“Me and My java' 1 ); 


System, out, pri ntl nfbookl.toStri n g ()) 
System, out, pri ntl n(book2.toStri ng ()) 
System, out. pri ntl n(book3.toStri ng ()) 
System, out, pri ntl n(book4.toStri ng ()) 


Running this program will produce the following output on the standard output 
window: 


Title unknown 

Introduction to OOP with java 
Java for Smarties 
Me and My java 


$0.50 
$0.75 
$ 1 . 00 
$1.50 


$ 50.00 

$ 50.00 

$ 100.00 
$ 230.00 


03/ 14/08 
02/13/08 
01/12/08 
01/01/08 
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step 2 
design 


step 2 code 


Step 2 Development: Integrate the BookTracker Class into the Program 

In the second development step, we will bring in the helper BookTracker class into the 
program. Our main concern in this step is to understand how to interact with a Book¬ 
Tracker object correctly and adjust the LibraryBook class, as necessary, to make it com¬ 
patible with the BookTracker class. 

The BookTracker class is actually a fairly straightforward class. You are encouraged 
to view the source file of the class. To understand the class fully, you need to learn about 
an ArrayList, a topic covered in Chapter 10. But even without this knowledge,you should 
be able to understand the majority of the code when you view the source file. We will 
discuss the implementation of the BookTracker class in Chapter 10. Here's the class 
description: 


BookTracker 

An instance of this class maintains a list of LibraryBook objects. 

public BookTracker! ) 

Creates a new instance of the class. 

public void add( LibraryBook book ) 

Adds book to the book list it maintains. 

public double get Charge! ) 

Returns the total overdue charge for the books in the list. Uses today as the 
return date. 

public double getCharge! Gregori anCaI endar returnDate ) 

Returns the total overdue charge for the books in the list. The parameter is the date 
the book is to be returned. 

public String get Li st ( ) 

Returns information on all books in the list as a single string. 


As stated in step 1, the BookTracker class requires two specific methods in the 
LibraryBook class. We already defined the toString method. Since we will be imple¬ 
menting the full computeCharge method in step 4, we define a stub method for this 
step as 

public double computeCharge! GregorianCalendar returnDate) { 
return 1.00; II Stub method for Step 2 

} 

To check our understanding on how to interact with the BookTracker class, we will 
write a test main class. From this main class, we will create and add multiple book objects 
to the book tracker and experiment with the getList and getCharge methods. 

The only change we make to the LibraryBook class is the addition of the stub 
computeCharge method, so the BookTracker class can be integrated with it. To test 
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the BookTracker class, we define a test main class that checks the cases when the book 
list is empty and has 20 books. Here's the test main class: 



Introduction to OOP with Java 4th ed. , McGraw-Hill 


File: Step2/Step2Mai n.j ava 

*/ 

import java,util.*; 
class S t e p 2 Mai n { 

public static void main) Stri ng 11 a r g s ) { 

II Create 20 Li braryBook objects 
BookTracker bookTracker = new BookTracker () ; 

Gregori anCaI endar dueDate, returnDate; 

Li braryBook book; 

returnDate = new Gregori anCal endar(2008, Calendar, MARCH, 15); 

//Check the error condition 

System, out. printlnj" Error: No books added, Return code - " + 

bookTracker. getCharge(returnDate) ) ; 

System, out. printlnj " Output for empty book I i s t: \ n" + 

bookTracker. getLi st( )); 

II Add 20 books 

System, out. pri ntl n("\n Ad ding 20 books. ,.\n“); 

for ( i nt i =0; i <20; i ++) { 

dueDate = new Gregori anCaI endar ( 2 0 0 8, Ca I endar. MARCH, i+1); 

book = new Li braryBook ( dueDat e) ; 
book, s e t Ti11 e ( "Book Number " + (i+1)); 

bookTracker. add(book); 

} 

System, out. pri ntl n ( “ Total Charge: $" 

+ bookTracker. getCharge(returnDate) ); 
System, out. pri ntl n("\n"); 

System, out. pri ntl n (" List: \n" + bookTracker. getLi st( )) ; 

} 

} 
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step 2 test 


We run the test main class and verify that we get the expected results. We will try 
other variations to increase our confidence before continuing to the next step. 


step 3 
design 


Step 3 Development: Define the OverdueChecker Class 

After the working LibraryBook and BookTracker classes, we are now ready to start im¬ 
plementing the top-level controller class. Besides managing a single BookTracker object 
and multiple LibraryBook objects, an OverdueChecker object's main responsibility is 
the handling of input and output routines. As dictated in the problem statement, we have 
to first input information on books and then repeatedly ask the user for return dates. 
Expressing this logic in pseudocode, we have 

GregorianCaI endar returnDate; 

String reply, table; 
double totalCharge; 

inputBooksl); II read in all book information 

table = bookTracker. getLi st( ); 

System, out. pri ntl nftabl e); 

II try different return dates 

do { 

returnDate = read return date ; 

totalCharge = bookTracker. getCharge(returnDate); 

di spl ayTotal Chargeftotal Charge); 

reply = prompt the user to continue or not ; 

} while ( reply is yes ); 


The body of the inputBooks method will include a loop that reads information for 
one book on each repetition.The method body can be expressed thus: 


whiIe (i sConti nue( )) { 


title 

chargePer Day 
ma x C h a r g e 
dueDat e 


readStri n g ( "Ti tl e 
read Doubl e( "Charge per day 
readDoubl e("Maxi mum charge 
r e a d Da t e ("Due Date 


book = createBook ( titI e, chargePerDay, 
maxCharge, dueDate); 

bookTracker, add(book); 

} 


Notice that there are three types of input data, and we define a method for each type, 
namely, readDouble, readDate, and readstring. These methods read input from a scan¬ 
ner (console input) after prompting the user. 
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Code to handle the input of String and double values is straightforward, but the 
one to handle the input of the date requires some thinking. We need to decide in which 
format the user can enter the date. For instance, should we prompt for the year, month, 
and day individually? This may be acceptable if you enter the date once. When you have 
to input date information many times, this input routine gets tedious. For this application, 
we will require the user to enter the date correctly as a single string value in the 
MM/dd/yyyy format. Given a string value in this format, we use a sequence of substring 
methods to break it down into three pieces—month, day, and year. This operation is 
similar to the one we used in the Chapter 2 sample application. Then we use the 
Integer.parselnt method, introduced in Chapter 3, to convert them to int values. From 
these three int values, we finally create and return a GregorianCalendar object that 
represents the entered date. 

After the four values are entered, a new book is created via the createBook method. 
This method handles the situation when the input value is empty. For example, the user 
may press only the Enter key if she wants default values for the single-day charge and 
maximum possible charge. 

The other methods are straightforward, so we'll refer you to the complete class list¬ 
ing without further explanation. Flere's the instantiable main class OverdueChecker: 
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Tracker; 



II Constructors 
II 

public OverdueChecker!) { 

scanner = new Scanner ( System, in); 
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scanner, useDel i mi ter(System, getProperty("l i ne, separator")); 
bookTracker = new BookTracker(); 


Ma i n Method 


public static void mai n(Stri ng[] args) { 

Over dueChecker checker = new OverdueChecker () ; 
checker, start)); 


Public Methods 


public void start) ) { 

Gregori anCaI endar returnDate; 

String table; 
double charge; 

Response response; 

input Books () ; 

table = bookTracker, getList)); 

System, out. println(table); 

System, out. pri ntl n("\nNow check the over due charges...\n" ); 
II try different return dates 

do { 


} 


II read return date 

returnDate = readDate ( "\nReturn Date: "); 
charge = bookTracker. getCharge(returnDate); 
di spl ayTotal Charge(charge); 
response = prompt) "\ nRun Again (yes/no)? "); 

} while (response == Response.YES ); 

System, out. println) 

"\n\nThank you for using Library Overdue Checker") 


Private Methods 


www.it-ebooks.info 








432 Chapter 7 Defining Your Own Classes—Part 2 


7.9 Sample Development— continued 


private LibraryBook c r ea t e Bo o k ( S t r i n g title, 

double chargePer Day, 
double maxCharge, 

GregorianCalendar due Date) { 

if ( dueDat e == null) { 

dueDate = new GregorianCalendar)); //set today as due date 

} 

LibraryBook book = new Li brary B o o k ( dueDat e) ; 

if (title.length)) >0) { 
book. setTitl e(title); 

} 

if (chargePer Day > 0.0) { 

book. setChargePerDay(chargePerDay); 

} 

if (maxCharge > 0.0) { 

book, set Maxi mumC harge(maxCharge) ; 

} 

return book; 

} 

private void dispI ay ( Stri ng text) { 

System, out. pri nt(text); 

} 

private void di spI ayTota I Charge ( doub I e charge) { 

System, out. format("\nTOTAL CHARGE:\t $ %8. 2 f" , charge); 

} 

private void i nput Books( ) { 

double chargePerDay, maxCharge; 

String title; 

GregorianCalendar dueDate; 

Li br ar yBook book; 

//Keeps on reading input from a console 
//until stopped by the end user 

while (isContinue(l) { 

System, out. pri ntl n("\n"); 

title =readString(" Title : "); 

chargePerDay = read Double) "Charge per day: "); 
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maxCharge = readDoubl e("Maxi mum charge: "); 
dueDate = readDate ("Due Date 

book = createBook ( titI e, chargePerDay, 
maxCharge, dueDate); 

bookTracker. add(book); 

} 

} 

private boolean is Continue! ) { 

Response response = p r o mp t ( " \ n Mo r e books to enter (y/n)?" ) ; 
return (response == Response,YES ) ; 

} 

private Response prompt(String question) { 

String input; 

Response response = Response,NO; 

System, out. pri nt(questi on + 11 (Yes - y; No - n): "); 
input = scanner, next ( ) ; 

if (i nput. equal s("Y") || i n p u t,e q u a I s ( " y" ) ) { 
response = Response.YES; 

} 

return response; 

} 

private double readDoubl e(String prompt) { 
di s pi a y ( pr ompt) ; 
return scanner, next Doublet); 

} 

private Gregor i anCa I endar readDate! String prompt) { 
GregorianCalendar cal; 

String yearStr, monthStr, dayStr, line; 
i nt sepl, s e p 2; 
di spl ay(prompt); 
line = scanner, n ext ( ) ; 
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i f 

( 1i ne.1 engt h( 
cal = n ul 1 ; 

) == 0) { 






} e 
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1 nt eger 

parse 

nt 
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ret 
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urn cal; 







private 

String reads 

t ri ng ( St r i n 

g prompt) { 





display(prompt); 
return scanner, n ext () ; 

} 

} 


Now we run the program multiple times, trying different input types and values. We 
also confirm that all control loops are implemented and working correctly. At this point, 
the code to compute the overdue charge is still a stub, so we will always get the same 
overdue charge for the same number of books. After we verify that everything is working 
as expected, we proceed to the next step. 


Step 4 Development: Compute the Overdue Charge 

In step 4, we complete the stub method that computes the overdue charge in the 
LibraryBook class. We have two GregorianCalendar objects for the due date and the 
return date. We first need to find out the number of days between the two. We then mul¬ 
tiply this number by the amount of charge per day to derive the total overdue charge. If 
this amount is more than the maximum possible charge, then the total charge is reset to 
this maximum value. Also, we need to check for the situation in which the return date has 
not passed the due date.The logic of this process is a simple computation once we find 
out the number of days between the two dates. So, how can we find it? 
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design 
alternative 1 


design al¬ 
ternative 2 


step 4 code 


step 4 test 


Reviewing the GregorianCalendar class, we see the get method can be used to 
retrieve different pieces of date information, such as year, month, and day. Using the 
method, we can get the month, day, and year information for two dates and compare 
these values. It may sound easy, but things can get tricky very quickly. Complexity arises 
from the facts that not every month has the same number of days and that the number of 
days for February can vary from year to year. This approach is doable, but not recom¬ 
mended. 

When we explore the class further, we notice there's another method, namely get- 
Time,that returns a Date object. In Chapter 6, we used this Date class to compute the ex¬ 
ecution time of a loop by finding the difference between the start and end times. We 
can apply the same technique here. But instead of using the getTime method, we can 
actually use the getTimelnMillis method and bypass the Date class altogether. The 
getTimelnMillis method returns the time elasped since the epoch to the date in mil¬ 
liseconds. By subtracting this since-the-epoch milliseconds value of the due date from the 
same of the return date, we can find the difference between the two. If the difference is 
negative, then it's not past due, so there's no charge. If the difference is positive, then we 
convert the milliseconds to the equivalent number of days and multiply it by the per-day 
charge to compute the total charge. Here's a simple way to do the conversion: 

private static final double Ml L LI S E C _ T 0_ DAY 

= 1.0 / 1 0 0 0 / 6 0 /~ 6 0 / 2 4; 

dayCnt = mi I I i sec * Ml LLI SEC_T0_ DA Y ; 

We will adopt the second approach. Here's the final computeCharge method of 
the LibraryBook class: 

public double computeCharge ( GregorianCaI endar returnDate) { 
double charge = 0.0; 

long dueTi me = dueDate, getTi mel nMi I Ii s () ; 
long returnTi me = return Date. getTime In Mi llis(); 

long diff = returnTi me - dueTi me; 

if (diff > 0) { 

charge = chargePer Day * diff * Ml LLI SEC_T0_DAY; 

if (charge > maximumCharge) { 
charge = maximumCharge; 

} 

} 

return charge; 

} 

We run the program mutiple times again, possibly using the same set of input data. 
We enter different input variations to try out all possible cases for the computeCharge 
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method. Try cases such as the return date and due date are the same, the return date oc¬ 
curs before the due date, the charge is beyond the maximum, and so forth. After we ver¬ 
ify the program, we move on to the next step. 


program 

review 


possible 

extensions 


Step 5 Development:Tying Up the Loose Ends and Future Extensions 

As always, we will perform a critical review of the program, looking for any unfinished 
method, inconsistency or error in the methods, unclear or missing comments, and so 
forth. We should also not forget to improve the program for cleaner code and better read¬ 
ability. This is especially true for the input routines. Are all the possible cases handled? Are 
the input routines easy to use? Will it be better if we allow different formats for entering 
the date information? 

We stated at the beginning of this section that it would be a better program if it 
warned the user, say, by popping a warning window or ringing an alarm, when the due 
date was approaching. Using this extended program, we enter the book data at the time 
we check out the book from the library. The program will store the entered information in 
a file, so we don't have to reenter the same data whenever we want to find out the total 
overdue charge. We can execute the program daily and be warned about the looming 
due dates. We can still run the program to find out the charges for the overdue books. 
Techniques necessary to implement such an extended program are covered in the later 
chapters of this book. 


Summary 


When a method returns an object, it is actually returning a reference to this 
object. 

The reserved word this is used to refer to a receiving object of a message 
from within this object's method. 

A class may include multiple methods with the same name as long as their 
signatures are different. The signature of a method refers to the name of the 
method and the number and data types of its parameters. They are called 
overloaded methods. 

A class may include multiple constructors as long as their signatures are 
different. They are called overloaded constructors. 

A constructor can call another constructor of the same class using the 
reserved word this. 

Class variables and class methods are declared by using the reserved word 

static. 

Class methods can access only the class variables and the class constants. 
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Instance methods can access all types of data members (i.e., both class and 
instance components). 

A rguments are passed to the methods by using the call-by-value scheme in 
which the value of an argument is passed. The value is the actual data in the 
case of a pri mitive data type and a reference to an object i n the case of a 
reference data type. 

Programmer-defined classes can be grouped into a programmer-defined 
package. 

Thejavadoc comment is the third style of comments used injava. From the 
javadoc comments in a class, a tool can generate its documentation in the 
HTML format. 


Key Concepts 


returning objects from methods 
self referencing pointer (this) 
overloaded methods 
method signatures 
multiple constructors 


copy constructors 
static initializers 
call-by-value scheme 
programmer-defined packages 
javadoc comments 


Review Exercises 

1. Consider the following classes. 

class Cat { 

private String name; 

private Breed breed; 

private double weight; 

public CatfStri ng name, 
this, n a me = name; 
this. breed = breed; 
this.weight = weight; 

} 

public Breed get B r e e d ( ) { 
return breed; 

} 

public double getWeight() { 
return weight; 

} 

//other accessors and mutators 


Breed breed, doubl e we i ght ) { 
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class Breed { 

private String name; 

private double average Wg t; II in lbs. 

public Breed(String name, double average Wg t ) { 
this, na me = name; 
this, averageWgt = average Wg t; 

} 

public double get We i g h t ( ) { 

return averageWgt; 

} 

//other accessors and mutators 


} 

Identify the invalid statements in the following main class. For each invalid 
statement, state why it is invalid. 

class Q1Mai n { 

public static void main(String[] args ) { 

Breed persian = new Breed! “Persian", 10.0); 

Cat chacha = new Cat (" Cha Cha", persian, 12.0); 

Cat bombom = new C a t ( " B o m Bom' 1 , "mix", 10.0); 

Cat puffpuff = new C a t (" P u f f Puff", chacha, 9,0); 

double diff = chacha. get We i g h t ( ) 

- persian.get We ight(); 

System, out. pri ntl n ( 

puffpuff. getBreedf). get Wei g h t ( )) ; 

} 

} 

2. Given the Cat and Breed classes from Exercise 1, what will be the output 
from the following code? 

class Q2 Mai n { 

public static void main(String[] args) { 

Cat my Cat = new C a t ( " wi n k y" , 

new Breed! "mix", 10.5), 9.5); 

System, out. pri ntl n ( my C a t. get Wei g h t ( )) ; 

System, out. pri ntl n ( my C a t. g e t B r e e d ( ) . get Wei g h t () ); 

} 

} 
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3. Given the Fraction class from Section 7.8, draw the state-of-memory 
diagram at the point immediately after the last statement is executed. 

Fraction f 1, f 2, f 3; 

f1 = new F r a c ti o n ( 3, 8); 
f 2 = new F r a c ti o n ( 2 , 3); 
f 3 = f 1. add ( f 2) ; 

4. Consider the following class. 

class Dog { 


private double weight; 


public boolean i sBi ggerThan ( Dog buddy) { 

return t h i s . get We i g h t ( ) > buddy, get We i g h t ( ) ; 

} 

public double g e t We i g h t () { 
return weight; 

} 

} 

For each of the following codefragments, complete the state-of-memory 
diagram by filling in the arrows for this and buddy. 

a Dog tuffy = new Dog (...) ; 

Dog puffy = new Dog (...) ; 

puffy.i sBi ggerThan(tuffy); 
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b. Dog tuffy = new D o g (...); 
Dog puffy = new Dog (...); 

tuffy.i sBi ggerThan(puffy) ; 



5. Complete the foil owing constructor. 

class Student { 

private String name; 
private int age; 
private Address address; 

public StudentfString name, int age, Address address) { 

//assign passed values to the data members 

} 

6. Which of the following groups of overloaded constructors are valid? 


a 

publ i 

Cat ( int age) { . . 

■ } 





publ i 

Cat ( double 

wgt ) { 

... } 




b. 

publ i 

Dog ( St r i ng 

n a me, 

double 

wei ght) 

{ ■■ 

■ } 


publ i 

Dog ( St r i ng 

n a me, 

double 

hei ght) 

{ ■■ 

■ } 

c. 

publ i 

Dog(Stri ng 

n a me, 

double 

wei ght) 

{ ■■ 

■ } 


publ i 

Do g ( double 

wei ght 

, String n a me) 

{ ■■ 

■ } 

d 

publ i 

Ca t ( St r i ng 

n a me ) 

{ ... 

} 




publ i 

Ca t ( St r i ng 

n a me, 

double 

wei ght) 

{ ■■ 

■ } 


publ i 

Cat ( double 

we i g h t ) { . . 

} 




7. Which of the following groups of overloaded methods are valid? 

a public void computefint num) { ... } 
public int compute(double num) { ... } 

b. public void move( doubl e length) { ... } 
public void move( ) { ... } 
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c. public 
public 


int adj ust(doubl e amount) 
void adj ust(double a mount, 


{ ... } 

double charge) { ... } 


d public 
public 
public 


void d o Wo r k ( ) { ... } 
void doWork(String name) 
int doWorkfdouble num) 



8. Complete the first four constructors of the foil owing class. Each of the four 
constructors calls the fifth one by using the reserved word this. 


class Cat { 


private 

st at i c 

final String 

DEFAULT 

NAME = “No name 

private 

static 

final int 

default’ 

HGT = 6; 

private 

static 

final double 

default’ 

WGT =10.0; 

private 

St ri ng 

n a me; 



private 

i nt 

hei ght; 



private 

double 

wei ght; 



public 

Cat ( ) 

{ 




//assign defaults to all data members 

} 


public Cat(String name) { 

//assign the passed name to the data member 
II use defaults for height and weight 

} 


public CatfString name, int height) { 

//assign passed values to name and height 
II use default for wei ght 

} 

public CatfString name, double weight) { 
//assign passed values to name and weight 
II use default for height 

} 


public Cat ( St ri 
t h i s. n a me = 
t hi s. hei ght 
t hi s. wei ght 


n g n a me, int 
n a me; 

= height; 

= wei ght; 


hei ght, 


double wei ght ) { 


9. Define a class method (static) named compare to the Fraction class. The 
compare method accepts two Fraction objects fi and f2. The method returns 

-1 if fi is less than f2 
o if fi is equal to f2 
+1 if fi is greater than f2 
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10. Rewrite the compare method from Exercise 9 by changing it to an instance 
method. This method accepts a Fraction object and compares it to the 
receiving object. The method is declared as follows: 

public int compare(Fracti on frac) { 

//compare the Fraction objects this and frac 
//return the result of comparison 

} 

11. Discuss the pros and cons of the compare methods from Exercise 8 and 
Exercise 9. 

12. Consider the following class. 

class Modifier { 

public static changef int x, int y){ 

x = x - 10; 
y = y + 10; 

} 

} 

What will bean output from the following code? 

int x = 4 0; 
int y = 20; 

Modifi er.change(x,y); 

System, out. pri ntl n("x = " + x); 

System, out. pri ntl n("y = " + y); 

Level 1 Programming Exercises ★ 

13. M odify the foil owing class to make it a part of the package named myutil. In 
addition to adjusting the source file, what are the steps you need to take so 
that the class becomes usable/accessible from other classes that are outside 
of this myutil package? 

class Person { 

private String name; 

public Person! ) { 

name = "Unknown"; 

} 

public String get N a me ( ) { 
return n a me; 

} 

public void setNa me (String name) { 
t h i s. n a me = n a me; 

} 

} 
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14. Write a program that tests the Person class defined in Exercise 13. Place this 
test program outside of the myutii package and make sure you can call the 
constructor and the methods of the Person class correctly. 

Level 2 Programming Exercises Ik ★ 

15. Design a class that keeps track of a student's food purchases at the campus 
cafeteria. A meal card is assigned to an individual student. When a meal card 
is first issued, the balance is set to the number of points. If the student does 
not specify the number of points, then the initial balance is set to 100 points. 
Points assigned to each food item area whole number. A student can purchase 
additional points at any time during a semester. Every time food items are 
bought, points are deducted from the balance. If the balance becomes 
negative, the purchase of food items is not allowed. There is obviously more 
than oneway to implement the MealCard class. Any design that supports the 
key functionalities is acceptable. Put this class in the myutii package. 

16. Write a program that tests the meal card class defined in Exercise 15. Define 
this test program outside the myutii package. Create one or two meal card 
objects in the test program and verify that all methods defined in the meal 
card class operate correctly. 

Development Exercises 

For the following exercises, use the incremental development methodology to 
implement the program. For each exercise, identify the program tasks, create a 
design document with class descriptions, and draw the program diagram. M ap out 
the development steps at the start. Present any design alternatives and justify your 
selection. Be sure to perform adequate testing at the end of each development step. 

17. Write an application that plays the game of Fermi. Generate three distinct 
random digits between 0 and 9. These digits are assigned to positions 1, 2, and 
3. The goal of the game is for the player to guess the digits in three positions 
correctly in the least number of tries. For each guess, the player provides three 
digits for positions 1, 2, and 3. The program replies with a hint consisting of 
Fermi, Pico, or Nano. If the digit guessed for a given position is correct, then 
the reply is Fermi. If the digit guessed for a given position is in a different 
position, the reply is Pico. If the digit guessed for a given position does not 
match any of the three digits, then the reply is Nano. FI ere are sample replies 
for the three secret digits 6, 5, and 8 at positions 1, 2, and 3, respectively: 

Guess Hint Explaiation 

12 5 Nano Nano Pico The value 5 matches but 

at the wrong position. 

8 5 3 Pico Fermi Nano The value 5 matches at the correct 

position. The value 8 matches 
but at the wrong position. 

5 8 6 Pico Pico Pico All match at the wrong positions. 
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Notice that if the hints like the above are given, the player can tell which 
number did not match, For example, given the hint for the second guess, we 
can tell that 3 is not one of the secret numbers. To avoid this, provide hints in 
a random order or in alphabetical order (e.g., it will be Fermi Nano Pico 
instead of Pico Fermi Nano for the second reply). 

Play games repeatedly until the player wants to quit. After each game, 
display the number of guesses made. 

Usejavadoc comments to document the cl asses you design for this 
application. 

18. Write an application that teaches children fraction arithmetic. For each 
training session, randomly generate 10 questions involving addition, 
subtraction, division, and multiplication of two fractions. At the beginning 
of each session, the user has the option of specifying the time limit for 
answering the questions. If the time limit is not specified, then use 30 s as a 
default time limit. After you pose a question, wait until the user answers the 
question. Award points based on the following rules: 


Answer Time Points 

Correct Under limit 10 

Correct Over limit 6 

Wrong Under limit 3 

Wrong Over limit 0 

After one session is over, use the console output to display the grade 
distribution and the total points in the following manner: 

Under Over 

T i me L i mi t T i me L i mi t 

Co r r e c t Ans we r s 4 3 

Wrong Answers 2 1 


TOTAL POI NTS: 64 (40 + 18 + 6 + 0) 

After one session is over, give the user the option to play another session. 
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Objectives 


After you have read and studied this chapter,you 
should be able to 

• Improve the reliability of code by 
incorporating exception-handling and 
assertion mechanisms. 

• Write methods that propagate exceptions. 

• Implement the try-catch blocks for catching 
and handling the thrown exceptions. 

• Write programmer-defined exception classes. 

• Distinguish between the checked and 
unchecked, or runtime, exceptions. 

• Use assertions in methods to increase the 
chance of detecting bugs during the 
development. 
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assertion 


exception 

handling 


hen someone says his or her program is reliable, what do we expect from the 
program? The majority of people would probably reply correctness as the most 
important criterion in determining the reliability of a program. When a program is 
claimed to be reliable, we certainly expect the program will produce correct results 
for all valid input. It is hardly a reliable program if it produces correct results only 
for some input values. As we all know by now, writing a correct program is easier 
said than done. If we are not diligent and careful enough, we can easily introduce 
bugs in our programs. And often we fail to eradicate them. A mechanism called an 
assertion can be used to improve the likelihood of catching logical errors during the 
development. We will introduce assertions in this chapter and show how to use them 
effectively in our programs. 

Program correctness guarantees correct results for all valid input. But 
what happens when the input is invalid? Another important criterion of program 
reliability is the robustness, which measures how well the program runs under 
various conditions. If a program crashes too easily when a wrong type of argu¬ 
ment is passed to a method or an invalid input value is entered, we cannot 
say the program is very robust. A mechanism called n handing can be 

used to improve the program's robustness. In this chapter, we will describe 
how to code this exception-handling mechanism in Java to improve the program's 
robustness. 


exception 


8.1 


Catching Exceptions 


In Chapters 5 and 6 we presented two types of control flows: selection control and 
repetition control. Using these control structures, we alter the default sequential 
flow of control. We use a selection control to select and execute one block of code 
out of many choices, and we use a repetition control to execute a block of code 
repeatedly until certain conditions are met. The exception-handling mechanism 
can be viewed as another form of control structure. An represents an 

error condition that can occur during the normal course of program execution. 
When an exception occurs, the normal sequence of flow is terminated and the 
exception-handling routine is executed. When an exception occurs, we say an 
exception is thrown, W hen the matching exception-handling code is executed, we say 
the thrown exception \scaught. By using exception-handling routinesjudiciously in 
our code, we can increase its robustness. In this section, we will show how the 
thrown exceptions can be caught and processed. 

We have been dealing with exceptions all along. For example, consider this 

code: 


Scanner scanner = new ScannerfSystem. in); 

System, out, print) "Enter integer: "); 
int number = scanner, nextlntj); 
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What would happen if we entered, say, abci23, an input value that is notan int? We 
would get an error message like this: 


Exception in thread “main" iava. util. Input Mi smat chExcept i on 


at j ava. ut 


I . Scanner. throwForf Scanner.i ava: 819) 


a t 

j a va, ut i 1 

. Scanner, next!Scanner.i ava 

: 1431) 

a t 

j a va. ut i 1 

. Scanner, nextl nt(Scanner.i 

ava: 2040) 

a t 

j a va. u t i 1 

. Scanner, nextl nt(Scanner.i 

ava: 2000) 


at Ch8SampI e 1. mai n( Ch8SampI el. i ava: 35) 


This error message indicates the system has caught an exception called the input- 
MismatchException, an error that occurs when we try to convert a stri ng that cannot 
be converted to a numerical value. Up until now, we have let the system handle 
the thrown exceptions. However, when we let the system handle the exceptions, 
a single thrown exception most likely will result in erroneous results or a program 
termination. Instead of depending on the system for exception handling, we can 
increase the program's reliability and robustness if we catch the exceptions our¬ 
selves by including error recovery routines in our program. 

Let's begin with a short program to illustrate the exception-handling 
mechanism. We will define a service class that supports a method to input a 
person's age. This class is mainly for the illustrative purpose of introducing the 
exception-handling concept. We first define it without exception handling and 
then improve it gradually by adding exception-handling features. Because we will 
be defining many different versions of the class, we will name them Agein¬ 
putVeri , AgeinputVer2, and so forth. Here's the AgeinputVeri class without ex¬ 
ception handling: 


W 

I * 

Chapter 8 Sample Class: Class to input age 
File: AgeinputVeri.java 

*/ 

import java,util.*; 
class AgeinputVeri { 

private static final String DEFAULT_MESSAGE = "Your age 

private Scanner scanner; 

public Agel nput Ver 1( ) { 

scanner = new ScannerfSystem. in); 

} 

public int g e t A g e () { 

return getAge ( DEFAULT MESSAGE); 

} 
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} 


public int getAge(String prompt) { 

System, out. print(prompt); 
int age = scanner, nextlntf); 

return age; 

} 


Using this service class, we can write a program that gets a person's age and 
replies with the year in which the person was born. N otice the program takes into con¬ 
sideration whether the person already had a birthday this year. Here's the program: 

/ * 

Chapter 8 Sample Program: Input a person's age 
File: Ch8Agel nputMai n.j ava 

*/ 

import java.util.*; 
class C h 8 A g e I nput Mai n { 

public static void main(String[] args) { 

GregorianCal endar today; 
int age, thisYear, bornYr; 

String answer; 

Scanner scanner = new Scanner( Syst em. in); 

AgelnputVerl input = new Age I nputVer1 ( ); 
age = input, g e t A g e ( " How old are you? "); 

today = new Gregori anCaI endar ( ); 
thisYear = today.get(Cal endar.YEAR); 

bornYr = thisYear - age; 

System, out. print! "Already had your birthday this year? (Y or N) " ) ; 
answer = scanner. next!); 

if ( answer.equal s( "N" ) || answer.equals("n") ) { 
bornYr--; 

} 

System, out. pri ntl n(“\nYou are born in " + bornYr); 

} 

} 
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The program works fine as long as valid input is entered. But what happens if 
the user spells out the age, say, nine instead of 9? An input mismatch exception is 
thrown because the input value nine cannot be converted to an integer by using the 
parseint method. With the current implementation, the system will handle the 
thrown exception by displaying the error message 

Exception in thread "main" java. util. Input Mi smatchExcepti on 
at j ava. u t i I. Scanner.t hrowFor(Scanner,j ava: 819) 
at j ava. utiI. Scanner, next(Scanner.j ava: 1431) 
at j ava, uti I . Scanner, next I nt(Scanner.j ava: 2040) 
at j ava. uti I . Scanner, next I nt(Scanner.j ava: 2000) 
at Agel nputVerl.get Age(Agel nputVerl.j ava: 48) 
at Ch8AgeI nputMai n. mai n( Ch8AgeI nputMai n.j ava: 30) 

and terminating the program. It would be a much better program if we could handle 
the thrown exception ourselves. Let's modify thegetAge method so thatitwill loop 
until a valid input that can be converted to an integer is entered. To do this, we need 
try-catch to wrap the statements that can potentially throw an exception with the try-catch 

control statement. In this example, there's only one statement that can potentially 
throw an exception, namely, 

age = scanner, nextlntf); 

W e put thi s statement i nsi de the try bl ock and the statements we want to be executed 
in response to the thrown exception in the matching catch block. If we just want 
to display an error message when the exception is thrown, then we can write the 
try-catch statement as follows: 

Sy s t em. o ut. p r i nt ( p r o mp t ) ; 

try { 

age = scanner, nextl nt(); 

} catch (I nputMi smatchExcepti on e) { 

The type of exception 
to be caught 

System, out. pri ntl n( 

"Invalid Entry. Please enter digits only."); 

} 

Statements i n the try bl ock are executed i n sequence. W hen one of the state¬ 
ments throws an exception, then control is passed to the matching catch block and 
statements inside the catch block are executed. The execution next continues to the 
statement that follows this try block statement, ignoring any remaining statements 
in the try block. If no statements in the try block throw an exception, then the catch 
block is ignored and execution continues with the statement that follows this 


A statement that 
could throw an 
exception 


www.it-ebooks.info 




450 Chapter 8 Exceptions and Assertions 


Exception 

Assume <t-stmt-3> throws an exception. 

try { 

<t-stmt-l> 

<t-stmt-2> 

<t-stmt-3> 

H This part is 
skipped. 

} catch (Exception e) { 
<c-stmt-l> 

, <c-stmt-n> 

’} 

<next stmt> 


No exception 


\ try { 

<t-stmt-l> 

<t-stmt-2> 

<t-stmt-3> 

<t-stmt-4> 

' r <t-stmt n> 

• } catch (Exception e) { 

<c-stmt-l> 

<c-stmt-n> 

\ > 

<next stmt> 


<t-stmt-4> 

<t-stmt-n> 


Figure 8.1 Two possible control flows of the try-catch statement with one catch block. Assume <t-stmt-3> 
throws an exception. 


try-catch statement. Figure 8.1 shows the two possible control flows: one when an 
exception is thrown and another when no exceptions are thrown. 

In the sample code, we have only one statement in the try block. If the input 
statement does not throw an exception, then we want to exit from the method and 
return the integer. If there's an exception, we display an error message inside the 
catch block, and repeat the input routine. To accomplish this repetition, we will put 
the whole try-catch statement inside a loop: 

public int getAge(String prompt) { 
int age; 

boolean keepGoi ng = t r ue; 
while ( keepGoi ng) { 

System, out. pri nt(prompt); 

try { 

age = scanner, nextl nt(); 
keepGoi ng = false; 

} catch (Input Mi smatchExcepti on e) { 

scanner. next(); //remove the leftover garbage 
/ / f r om t he input buffer 

System, out. pri n 11 n ( 


This statement is executed 
only if no exception 
is thrown. 

This will remove 
"garbage"left in the 
input buffer. 
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"Invalid Entry.Please enter digits only."); 

} 

} 

return age; 

} 

N oti ce the fi rst statement 

scanner. next(); 

inside the catch block. It is used to remove any data that remain in the input buffer. 
When an exception is thrown, an input value that has caused an exception still 
remai ns in the input buffer. We need to remove this "garbage" from the i nput buffer, 
so we can process the next input value. If we don't include this statement, the code 
will result in an infinite loop because the nextint method continues to process the 
same invalid input. 

We can get rid of the boolean variable by rewriting the statement as 

while (true) { 

System, out. pri nt(prompt); 

try { 

age = scanner, ne xtI n t ( ); 
return age; 

} catch (Input Mi smatchExcepti on e) { 

scanner, next (); //remove the leftover garbage 
/ / f r om t he Input buffer 

System, out. pri ntl n( 

"Invalid Entry. Please enter digits only. 11 ); 

} 

} 

The improved class with the exception-handling getAge method is named 
AgelnputVer2. 

T here are many types of exceptions the system can throw, and we must specify 
which exception we are catching in the catch block's parameter list (there can be 
exactly one exception in the list). In the sample code, we are catching the input 
mismatch exception, and the parameter e represents an instance of the inputMis- 
matchException class. In Java an exception is represented as an instance of the 
Throwabie class or its subclasses. TheThrowabie class has two subclasses, Error and 
Exception. The Error class and its subclasses represent serious problems that should 
not be caught by ordinary applications, while the Exception class and its subclasses 
represent error conditions that should be caught. So for all practical purposes, we are 
only interested in the Exception class and its subclasses in our program. Later in the 
chapter wewill learn how to define our own exception classes. We will declare these 
programmer-defined exception classes as subclasses of the Exception class. 
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There are two methods defined in the Throwable class that we can call to get 
some information about the thrown exception: getMessage and printstackTrace. We 
can call these methods inside the catch block as follows: 

try { 

age = scanner, nex11 nt (); 
return age; 

} catch (Input Mi smatchExcepti on e) { 

scanner,next (); //remove the leftover garbage 
//from the input buffer 

System, out. pri ntl n(e.getMessagef)); 
e. pri nt St a c kTr ac e( ); 

} 

With this modified code, if we enter ten as an input, then we will receive the 
following output: 

getMessage null 

( j ava. u f i I . i nput Mi smat chExcept i on 

at j ava, utiI. Scanner.throwFor(Scanner.j ava: 819) 
at java, utiI.Scanner. next(Scanner.java:1431) 
printstackTrace at j ava. uti I . Scanner, nextl nt(Scanner.j ava: 2040) 

at j ava, uti I . Scanner, nextl nt(Scanner.j ava: 2000) 
at Agel n p u t V e r 2. getAgefAgel nputVer2.j ava: 54) 
at Ch8AgeI nputMai n. mai n ( Ch8AgeI nputMai n. j ava: 30) 

Notice that the result we see from the printstackTrace method is the one we saw when 
the system handled the thrown exception. The stack trace shows the sequence of calls 
made from the main method of the main class to the method that throws the exception. 


W 

Quick 

CHECK 


1. What will be displayed on the console window when the following code is 
executed and the user enters abcl23 and 14? 

Scanner scanner = new Scanner(System. in); 

try { 

int numl = scanner, nextl nt(); 

System, out. pri ntl n("l nput 1 accepted 1 '); 
int num2 = scanner, nextl nt(); 

System, out. pri ntl n("l nput 2 accepted"); 

} catch (I nputMi smatchExcepti on e) { 

System, out. pri ntl n ( " I nval id Entry"); 

} 
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2. What is wrong with the following code? It attempts to loop until the valid input 
is entered. 

Scanner scanner = new ScannerfSystem. in); 

try { 

whiIe (true) { 

System, out. print)" Enter input: "); 
int num = scanner, n ex11 nt () ; 

} 

} catch (Input Mi smatchExcepti on e) { 
scanner. next(); 

System, out. p r i n 11 n (" Invalid Entry"); 

} 


8.2 Throwing Exceptions and Multiple catch Blocks 

Compared to the original Ageinputveri class, the AgeinputVer2 class is more robust 
because the program does not terminate abruptly when an invalid value is entered. 
However, the improved class is not robust enough yet. There is still room for im¬ 
provements. For example, the current implementation accepts invalid negative inte¬ 
gers. Sincenegativeageisnot possible, let's improvethecode by disallowing the input 
of negative integers. Notice that a negative integer is an integer, so the nextint method 
will not throw an exception. We will define the third class, AgeinputVer3, to throw 
(and catch) an exception when the invalid input of a negative integer is detected. 
Here's the while loop of the modified getAge method of the Ageinputver3 class: 


Throws an excep¬ 
tion when age is a 
negative integer. 


The thrown exception 
is caught by this 
catch block. 


whiIe (true) { 

System, out. pri nt(prompt); 

try { 

age = scanner, nextint)); 
if (age < 0 ) { 

throw new Exception) "Negative age is invalid"); 

} 


return age; //input okay so return the value & exit 
} catch (I nputMi smatchExcepti on e) { 
scanner, next () ; 

System, out. pri n 11 n ( " Input is invalidin' 1 + 

"Please enter digits only"); 

() " "c a" tc" h" " ( "E xc e’p t"i" o’ n" " e’f 

System, out. print Inf" Error: " + e.getMessage(l); 

[} 

} 
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An exception is thrown by using the throw statement. Its syntax is 
throw <a throwable o b j e c t > 

where <a throwable object> is an instance of the Throwable class or its subclasses. 
As mentioned earlier, in common applications, it will bean instance of the Exception 
class or its subclasses. In the sample code, we threw an instance of the Exception 
class. When we create an instance of the Exception class, we can pass the string that 
describes the error. The thrown exception is caught by the corresponding catch 
block, and this error message is displayed. 

Notice the multiple catch blocks in the sample code. When there are multi¬ 
ple catch blocks in a try-catch statement, they are checked in sequence, and 
because the exception classes form an inheritance hierarchy, itis important to check 
the more specialized exception classes before the more general exception classes. 
For example, if we reverse the order of the catch blocks to 

try { 


} catch (Exception e) { 

} catch (Input Mi smatchExcepti on e) { 

} 

then the second catch block will never be executed because any exception object 
that is an instance of Exception or its subclasses will match the first catch block. 
When an exception is thrown, a matching catch block is executed and all other catch 
blocks are ignored. This is similar to the switch statement with break at the end of 
each case block. The execution continues to the next statement that follows the 
trycatch statement. When no exception is thrown, all catch blocks are ignored and 
the execution continues to the next statement. Figure 8.2 illustrates the control flow 
of the try-catch statement with multiple catch blocks. 



liinqs to Remember 


List the catch blocks in the order of specialized to more general exception classes. 
At most one catch block is executed, and all other catch blocks are ignored. 


The sample code given at the beginning of this section illustrates how an ex¬ 
ception can be thrown and caught by the matching catch block. Instead of catching the 
thrown exception immediately, itis possible to let others handle the exception. This 
can be achieved by not including a matching catch block. We assume in Figure 8.2 
that one of the catch blocks will match the thrown exception, but it is not a require¬ 
ment. It is possible that none of the catch blocks matches the thrown exception. 
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Exception No exception 


Assume <t-stmt-3> throws an exception and 
<catch-block-3> is the matching catch block. 


\ try { 

\ try { 


<t-stmt-l> 


<t-stmt-l> 


<t-stmt-2> 


<t-stmt-2> 


<t-stmt-3> 


<t-stmt-3> 

/ 

<t-stmt-4> 


<t-stmt-4> 

1 

<t-stmt-n> 


<t-stmt-n> 

; 


/ 


\ 

<catch-block-l> 

/ 

<catch-block-l> 

\ 

<catch-block-2> 

/ 

<catch-block-2> 

' 

<catch-block-3> 

; 

<catch-block-3> 


<catch-block-4> 

; 

<catch-block-4> 

; 

<catch-block-n> 

* % 

<catch-block-n> 


<next stmt> 

\ 

<next stmt> 


Skipped portion 




Figure 8.2 Two possible control flows of the try-catch statement with multiple catch blocks. Assume 
<t-stmt-3> throws an exception and <catch-block-3> is the matching catch block. 


If there is no matching catch block, then the system will search down the stack trace 
for a method with a matching catch block. If none is found, then the system will 
handle the thrown exception. We will explain this traversing of the stack trace in 
greater detail in Section 8.3. 

If there is a block of code that needs to be executed regardless of whether an 
exception is thrown, then we use the reserved word finally. Consider this code. 

try { 

num = scanner. nextlnt(); 

if ( num > 100) { 

throw new Exception) “Out of bound"); 

} 

} catch (I nputMi smatchExcepti on e) { 

scanner, next)); 

System, out. printlnf" Not an integer"); 

} catch (Exception e) { 

System, out. print Inf" Error: "+ e.get Message!)); 

} finally { 

System, out. pri ntl n(" DONE" ) ; 

} 
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If there is no error in input, then no exception is thrown and the output will be 
DONE 

If there is an error in input, one of the two exceptions is thrown and the output 
will be 


Not an integer 
DONE 


or 


Error: Out of bound 
DONE 

The example shows that the finally block is always executed. This feature is use¬ 
ful in a situation where we need to execute some cleanup code after the try-catch state¬ 
ment. For example, suppose weopen a communication channel from ourj ava program 
to a remote Web server to exchange data. If the data exchange is successfully com¬ 
pleted in the try block, then we close the communication channel and finish theopera- 
ti on. I f the data exchange i s i nterrupted for some reason, an excepti on i s throw n and the 
operation is aborted. In this case also, we need to close the communication channel, 
because leaving the channel open by one application blocks other applications from 
using it. Closing a channel is much like hanging up the phone. The code to close the 
communication channel should therefore be placed in the finally block. Figure 8.3 
shows two possible control flows for the try-catch statement with the finally clause. 


Exception 

Assume <t-stmt-i> throws an exception and 
<catch-block-i> is the matching catch block. 

\ try { 

"1 <t-stmt-l> 


<t-stmt-i> 



f i nal I y { 

} 

'<next statement> 


Skipped portion 


No exception 

V tr Y * 

""I <t-stmt-l> 

<t-stmt-i> 

t <t-stmt-n> 

/'> 

• <catch-block-l> 
<catch-block-i> 

\ <catch-block-n> 

fi nal ly { 

> 

'’<next statements 


Figure 8.3 Two possible control flows of the try-catch statement with multiple catch blocks and the finally 
block. The finally block is always executed. 
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Note that even if there's a return statement inside the try block, the finally 
block is executed. When the return statement is encountered in the try block, 
statements in the finally block are executed before actually returning from the 
method. 


W 

Quick 

C T 


1. What’s wrong with the following code? Identify all errors. 

Scanner scanner = new Scanner(System. in); 

try { 

int num = scanner. nextlntf); 
if ( num > 100) { 

catch new Exception) "Out of bound"); 

} 

} catch (Input Mi smatchExcepti on e) { 

System, out. p r i n 11 n ( " Invalid Entry"); 

} fi nal I y( Excepti on e) { 

System, out. pri ntl n(" DONE" ); 

} 

2. Determine the output of the following code when the input al2 is entered. 

Scanner scanner = new Scanner(System. in); 

try { 

int num = scanner, ne xtI nt ( ); 
if ( num < 0 ) { 

throw new Exception! “No negative"); 

} 

} catch (Input Mi smatchExcepti on e) { 

System, out, printing 1 Invalid Entry"); 

} catch (Exception e) { 

System, out. pri ntl n ( " Error: " + e. get Message(l); 

} finally { 

System, out. pri ntl n(" DONE" ); 
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3. Determine the output of the following code when the input al2 is entered. 

Scanner scanner = new Scanner(System. in); 

try { 

int num = scanner, nextlntf); 
if (num < 0 ) { 

throw new Exception) "No negative"); 

} 

} catch (Exception e) { 

System, out. pri ntl n("Error: 11 + e, g e t Me s s a g e ( )) ; 

} catch (Input Mi smatchExcepti on e) { 

System, out. pri ntl n ( " I nval id Entry"); 


exception 

thrower 

exception 

catcher 

exception 

propagator 


8.3 


Propagating Exceptions 


In Section 8.2 we introduced the possibility of no catch block matching the thrown 
exception, but we did not explain exactly how the system handles such a case. We 
stated only briefly that the system will search down the stack trace for a method 
with a matching catch block, and if no matching catch block is found, the system 
will handle the thrown exception. We now describe this mechanism in detail. 

To present a precise description, we start with some definitions. When a 
method may throw an exception, either directly by including a throw statement or 
indirectly by calling a method that throws an exception, we call the method an 
0 (ception thrower. Every exception thrower must be one of the two types: catcher or 
propagator. An ^on catch is an exception thrower that includes a matching 
catch block for the thrown exception, while an does not. For 

example, the getAge method of the AgeinputVeri class is an exception propagator, 
while the getAge method of the AgeinputVer2 class is an exception catcher. Note 
that the designation of a method as being a catcher or propagator is based on a sin¬ 
gle exception. Suppose a method throws two exceptions. This method can be a 
catcher of the first exception and a propagator of the second exception. 

Let's consider the sequence of method calls shown in Figure 8.4. M ethod A 
calls method B, method B in turn calls method C, and so forth. Notice the stack 
trace in the figure. Every time a method is executed, the method's name is placed 
on top of the stack. B y the ti me method D i s executed, we have A, B, C, and D i n 
the stack. When an exception is thrown, the system searches down the stack from 
the top, looking for the first matching exception catcher. Method D throws an 
exception, but no matching catch block exists in the method, so method D is 
an exception propagator. The system then checks method C. This method is also an 
exception propagator. Finally, the system locates the matching catch block in 
method B, and therefore, method B is the catcher for the exception thrown by 
method D. 
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Method A Method B Method C Method D 



Call sequence 

Method A 


Stack trace 


Method C ■ 

Propagator 


Method D 

Propagator 




B 


C 

B 


D 

C 

B 





A 


A 


A 


A 


Figure 8.4 A sequence of method calls among the exception throwers. Method D throws an instance of 
Exception. The green arrows indicate the direction of calls.The red arrows show the reversing of call sequence, 
looking for a matching catcher. Method B is the catcher in this example. The call sequence is traced by using a 
stack. (Note: output == System.out.) 


M ethod A also includes the matching catch block, but it will not be executed 
because the thrown exception is already caught by method B, and method B does 
not propagate this exception. A Ithough the technique is not used often, an exception 
catcher can also be set to propagate the caught exception. For example, if werewrite 
method B as 


try { 

CO; 


} 


} 


catch (Exception e) { 

II do so me thing here 

throw e; //propagate the caught exception to the 

//method below this one in the trace stack 


it is both a catcher and a propagator. With the modified method B, method A's 
matching catch block will get executed, because method B, in addition to handling 
the exception, throws the same exception, causing the system to look for a match¬ 
ing catcher down the stack. 

We have one last detail to complete the description of the exception propaga¬ 
tion mechanism. If a method is an exception propagator, we need to modify its 
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header to declare the type of exceptions the method propagates. We use the reserved 
word throws for this declaration. MethodsC and D in F i g u re 8.4 must have the fol¬ 
lowing declaration (visibility modifier and return type are not relevant here): 

void C( ) throws Exception { 

} 

void D( ) throws Exception { 

} 

Without the required throws Exception clause, the program will not compile. 
There is one exception (no pun intended) to this rule. For the exceptions of the 
type called runtime exceptions, the throws clause is optional. For example, 
the getAge method of AgeinputVeri does not include the throws clause be¬ 
cause inputMismatchException is a runtime exception. Its being optional means 
we can include it to explicitly state the fact if we want to. If we restate the 
declaration to 

public int getAge(String prompt) 

throws InputMismatchException { 

} 

the code will compile just fine. We will explain further about different types of 
exceptions in Section 8.4. 

Now that the exception propagation mechanism is explained, let's study how 
we can apply it in designing useful service classes. 

F i rst, consi der the Fraction cl ass from C hapter 7. T he setDenominator method 
of the Fraction class was defined as follows: 

public void setDenomi nator(int denom) { 
if (denom == 0) { 

System, out. pri ntl n ( "Fatal Error"); 

System, exi t(l); 

} 

denominator = denom; 

} 

We stated in Chapter 7 that it is too drastic to terminate a whole program when one 
attempts (inadvertently or otherwise) to set the denomintor to 0. Throwing an ex¬ 
ception is a much better approach. Here's the modified method that throws an 
HlegalArgumentException when the value of 0 is passed as an argument: 

public void setDenomi nator(int denom) 

throws I I I egal ArgumentExcepti on { 
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if (denom == 0) { 

throw new I I I egal ArgumentExcepti on( 

"Denomi nator cannot be 0" ); 

} 

denomi nator = denom; 

} 

Now let's study another example. Consider the AgeinputVer3 class. It dis¬ 
allows input of negative integers. When that happens, an exception is thrown. 
Instead of disallowing only negative integers, wouldn't it make more sense to 
restrict the valid input by specifying the lower and upper bounds? For example, we 
may want to restrict the input to an integer between 10 and 20 for one application 
and between 0 and 250 (e.g., entering the age of a building on the campus) for 
another application. To illustrate this concept, we will define the fourth class, 
AgeinputVer4, that allows the client programmers to specify the lower and upper 
bounds of acceptable input values. 

The client specifies the lower and upper bounds at the time of object creation, 
for example, 

Agel nputVer4 input = new Age I nputVer4 ( 10, 20); 

This constructor will set the lower and upper bounds to 0 and 99, respectively. The 
lower and upper bounds are kept as data members lowerBound and upperBound, 
respectively, and they are initialized in the constructor. 

How should the getAge respond when it detects the input is outside the 
range of the client-designated lower and upper bounds? Instead of catching it, 
we will propagate the thrown exception to the caller of this method. Our responsi¬ 
bility as a provider of the service class is to tell the client by throwing an excep¬ 
tion when a condition set by the client is violated. We will let the client handle 
the thrown exception. The condition is set by the client, so it is more appropriate 
for this client to decide what to do in case of an exception. For the number format 
exception, the getAge method is still the catcher because this exception is thrown 
when a condition not dependent on any one specific client is violated. This 
exception is not a client-specific exception, but a generic exception suitably han¬ 
dled by the service class. So the modified getAge method is a propagator of an 
Exception (thrown when the bounds set by the client are violated) and a catcher 
of an inputMismatchException (thrown when the input is not an integer). Here's 
the method: 


public int getAge(String prompt) throws Exception { 
i nt age; 

Propagates an 

while (true) { Exception 

System, out.print(prompt); 

try { 

age = scanner, n e x 11 n t () ; 
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No catch block for 

Exception 


if (age < I owerBound || age > upper Bound) { 
throw new Exception! "Input out of bound"); 

} 


} 


return age; 

} catch (Input Mi smatchExcepti on e) { 
scanner, next () ; 

System, out. p r i n 11 n ( " Input is invalidin' 1 + 

"Please enter digits only 11 ); 


} 


} 



hinas to Remember 


Don't catch an exception that is thrown as a result of violating the condition set 
by the client programmer. Instead, propagate the exception back to the client 
programmer's code and let him or her handle it. 


The second getAge method that uses a default prompt cal Is this method, so we 
need to rewrite the second getAge method as 

public int g e t A g e () throws Exception { 

r r i This call can throw an 

return get Age( DEFAULT MESSAGE); 

* ~ header must include the 

1 correct throws clause. 

We have to specify the additional data members and the constructors to com¬ 
plete the AgeinputVer4 class. The new data members are declared as 

private static final i nt DEFAULT LOWER BOUND = 0; 
private static final i nt DEFAULT~UPPER~ BOUND = 99; 

private int I owerBound; 
private int upper Bound; 

W hat about the constructors? A re the following constructors acceptable? 

public AgelnputVer4( ) { 

t his ( DEFAULT LOWER BOUND, DEFAULT UPPER BOUND); 

} 

public Ag e I n p u t Ve r 4 ( i nt low, int high) { 

I ower Bound = low; 

upper Bound = high; 

scanner = new Scanner(System. in); 

} 
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Yes, if we didn't know about exception handling. But now with the knowledge of 
exception handling, we can make the class more robust by ensuring that low is less 
than or equal to high. If this condition is not met, then we throw an exception. The 
NlegalArgumentException class is precisely the class we can use for this situation. 
H ere's the more robust constructor: 

public Age I n p u t Ve r 4 ( i nt low, i nt high) 

throws I I I egal ArgumentExcepti on { 

if (I ow > hi gh) { 

throw new NlegalArgumentException! 

“Low(" + low + ") was " + 

"larger than high!" + high + " ) " ) ; 


} else { 

I ower Bound = low; 

upper Bound = high; 

scanner = new Scanner! Syst em. in); 

} 

} 

Now, what about the default constructor? Since the default constructor calls 
the other two-argument constructor, which can throw an exception, this constructor 
must handle the exception. One approach isto propagate the exception by declaring 
it as 


public AgelnputVer4( ) throws NlegalArgumentException { 
this! DEFAULT LOWER BOUND, DEFAULT UPPER BOUND); 

} 

This declaration is problematic, however, because when we use the throws clause, 
we are announcing that this method can potentially throw an exception. But this 
constructor will never throw an exception as long as the class is programmed cor¬ 
rectly. The only time this constructor can throw an exception is when we set the 
value for default_lower_bound or default_upper_bound incorrectly. It is an 
internal error and must be corrected. Since this constructor should not throw an ex¬ 
ception, we might be tempted to make this constructor an exception catcher as 

public AgelnputVer4( ) { 

try { 

t hi s( DEFAULT,LOWER_BOUND, DEFAULT_UPPER_BOUND); 

} catch (NlegalArgumentException e) { 

//never happens, so do nothing 

□ * 

} 

Logically, this is what we want to accomplish. But syntactically, it is an error. Java 
requires the call to another constructor using the reserved word this to be the first 
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statement. In the bad version, the try statement is the first statement. To correct this 
problem, we can define a private method init as 

private void i n i t ( i n t low, i nt high) { 

I ower Bound = low; 

upper Bound = high; 

scanner = new scanner! Syst em. in); 

} 

and write the two constructors as 

public AgelnputVer4( ) { 

init(DEFAULT LOWER BOUND, DEFAULT UPPER BOUND); 

} 

public Ag e I n p u t Ve r 4 ( i nt low, i nt high) 

throws I I I egal ArgumentExcepti on { 

if (low > high) { 

throw new I I I egal ArgumentExcepti on( 

"Low ( " + low + " ) was " + 

"larger than hi gh( " + high + " ) " ) ; 


} else { 

i n i t (I o w, high); 

} 


Here's the complete Ageinputver4 class: 



Chapter 8 Sample Class: Class to input age 


File: Agel nputVer4.j ava 


*/ 

import java,util.*; 
class Agel nputVer4 { 

private static final String DEFAULT_MESSAGE = "Your age 
private static final int DEFAULT LOWER BOUND = 0; 
private static final i nt DE FAULT" UP P E R~ BOUND = 99; 

private int I ower Bound; 
private int upper Bound; 

private Scanner scanner; 


f \ 

Data members 
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} 


public Agel nput Ver 4( ) { 

i ni t ( DEFAULT LOWER BOUND, DEFAULT UPPER BOUND); Constructors 

} 

public Ag e I n p u t Ve r 4 ( i nt low, i nt high) 

throws I I I egal ArgumentExcepti on { 

if (I ow > hi gh) { 

throw new I I I egal ArgumentExcepti on( 

"Low ( " + low + " ) was " + 

"larger than hi gh( " + high + " ) " ) ; 

} else { 

i n i t (I o w, high); 

} 

} 

public int g e t A g e () throws Exception { getAge 

return getAge ( DEFAULT MESSAGE); 

} 

public int getAge(String prompt) throws Exception { 
int age; 

whiIe (true) { 

System, out. pri nt(prompt); 


try { 

age = scanner. nex11 nt () ; 


if (age < I owerBound || age > upper Bound) { 
throw new Exception! “Input out of bound"); 

} 

return age; //input okay so return the value & exit 
} catch (Input Mi smatchExcepti on e) { 
scanner. next(); 


System, out. p r i n 11 n ( " Input is invali 
"Please enter di 



} 


d. \ n 
gits 


private void init(int low, int high) { 
I ower Bound = low; 
upper Bound = high; 
scanner = new Scanner ( System, in); 

} 


+ 

o n I y" ); 



■ 
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Quick 

CHECK 

1. What's wrong with the following code? 

public void check( i n t num) { 
if ( num < 0 ) { 

throw new Exception)); 

} 

} 

2. W hat is the difference between the reserved words throw and throws? 

3. What’s wrong with the following code? 

public 1 nputMi smatchExcepti on get D a t a ( ) { 

Scanner scanner = new Scanner ( System, in); 

try { 

System, out. pri nt("l nput: " ) ; 
int num = scanner. nextlntf); 

return num; 

} 

} 

checked and 

unchecked 

exception 

8.4 Types of Exceptions 

We mentioned briefly in Section 8.1 that all types of thrown errors are instances of 
the Throwable class or its subclasses. Serious errors that signal abnormal conditions 
are represented by the instances of the Error class or its subclasses. Exceptional 
cases that common applications are expected to handle are represented by the 
instances of the Exception class or its subclasses. Figure 8.5 shows a very small por¬ 
tion of the inheritance hierarchy rooted in the Throwable class. 

There are two types of exceptions: checked and unchecked. A checked 
is an exception that is checked at compile time. All other exceptions are 
unchecked eca , also called runtime exceptions, because they are unchecked 

at compile time and are detected only at runtime. Trying to divide a number by 0 
(ArithmeticException) and trying to convert a string with letters to an integer 
(NumberFormatException) are two examples of runtime exceptions. 

If a method is a propagator (a method that throws but does not catch an 
exception) of checked exceptions, then the method must have the throws clause. If a 
method is a propagator of runtime exceptions or errors (instances of Error or its sub¬ 
classes), the throws clause is optional. When we call a method that can throw 
checked excepti ons, then we must use the try-catch statement and place the cal 1 i n the 
try block, or we must modify our method header to include the appropriate throws 
clause. When we call a method that can throw runtime exceptions or errors, then 
there's is no such requirement. We just make a call in our method. Figure 8.6 shows 
the valid callers of a method that throws checked exceptions, and Figure 8.7 
shows the valid callers of a method that throws runtime, or unchecked, exceptions. 
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Figure 8.5 Some classes in the inheritance hierarchy from the Throwable class. There are over 60 classes in 
the hierarchy. 


Caller A (catcher) 



Figure 8.6 Callers of a method that can throw a checked exception must explicitly include the try-catch 
statement in the method body or the throws clause in the method header. 


Enforcing the requirement of explicitly handling runtime exceptions means, 
for all methods we write, that they must either have the throws clause in the header 
or have the try-catch statement in the body because almost every method we call 
from our methods can throw runtime exceptions. This is hardly effective program¬ 
ming so we don't have to handle runtime exceptions explicitly in the program. For 
the errors of type Error and its subclasses, they indicate problems too serious for any 
ordinary application to handle, so we are not required to handle them explicitly. 
There's really nothing we can do even if we catch them, so we don't. 
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Caller A (catcher) 



Figure 8.7 It is optional for the callers of a method that can throw runtime, or unchecked, exceptions to 
include the try-catch statement in the method body or the throws clause in the method header. 



{ ings to Remember 

If a method throws a checked exception, the caller of this method must explicitly in¬ 
clude the try-catch statement or the throws clause in the method header. If a 
method throws a runtime, or unchecked, exception, the use of the try-catch 
statement or the throws clause is optional. 


r— 

Quick 

CHECK 

V 


1. Is this code wrong? 

public void c h e c k ( i n t num) { 
if (num < 0 ) { 

throw new I I I egal ArgumentExcepti on() ; 

} 

} 

2. W hat is the difference between the checked and unchecked exceptions? 
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8.5 Programmer-Defined Exceptions 

In the AgelnputVer4 class, the getAge methods throw an instance Of the Exception 
class. The catch clause of the caller of the getAge method can use the getMessage 
method to retrieve the error message or use printstackTrace to display the sequence 
of method calls from the main method to the method that threw an exception. But 
there's no way for the client to get any other useful information such as the value 
actually entered by the user. Instead of using generic exception classes, we can de¬ 
fine our own exception classes so we can attach useful information to the exception 
objects. 

Let's define a class named AgeinputException as a subclass of the Exception 
class. To provide useful information to the client, we will define the class so the 
instances will carry three pieces of information: lower bound, upper bound, and the 
value entered by the user (in addition to the message inherited from the Exception 
class). We will define three public methods to access these data. Here's the class 
definition: 



Chapter 8 Sample Class: Customized Exception Class 


File: AgeinputException.java 

*/ 


class AgeinputException extends Exception { 


private static final String DEFAULT_MESSAGE = "Input out of bounds": 

private int I ower Bound; 
private int upper Bound; 
private int value; 


public Agel nput Except i on( i nt low, int high, int input) { 
t hi s ( DEFAULT MESSAGE, low, high, input); 

} 


public Agel nputExcepti on(Stri ng msg, 

int low, int 


s u p e r ( ms g ); 


high, 


i nt input) { 


if (I ow > hi gh) { 

throw new Illegal Argume ntExceptionf); 

} 


I ower Bound = low; 
upper Bound = high; 
value = i nput; 
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} 


public i nt I ower Bound) ) { 
return I owerBound; 

} 

public i nt upper Bound) ) { 
return upper Bound; 

} 

public i nt value)) { 
return value; 

} 


The new AgeinputVerS class is essentially the same as the AgeinputVer4 class 
exceptthe getAge method of the new class throws an AgeinputException. A sample 
main class that uses the AgeinputVerS is as follows: 


Chapter 8 Sample Program: Input a person's age 
File: C h 8 T e s tAgel nputVer5.j ava 


class Ch8TestAgelnputVer5 { 

public static void main) Stri n g ) 1 a r gs ) { 
int entrant Age; 


try { 

AgeinputVerS input = new Age I nputVer 5 ( 2 5, 5 0 ); 
entrantAge = i nput.getAge ( " Your Age:”); 

System, out. pri ntl n("l nput Okay, Age = " + entrantAge); 


e's methods are called 
to get info 


catch (AgeinputException e) { 

System, out. println) 

Error: " + e. value)) + " 
outside the valid range 
, " + e. u p p e r B o u n d () + " 


is entered. It is " + 
of [ " + e.lowerBound)) + 
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ings to Remember 


To provide useful information to the client programmers when an exception occurs, 
define a new exception class. Make this customized exception class a subclass of 

Exception. 


When we create a new customized exception class, we should define it as a 

B checked exception, and the most logical choice for its superclass is the Exception 
class. We should not define the customized exception class as an unchecked 
exception. If we did, then the client programmers would have an option of omit¬ 
ting the try-catch statement or the throws clause in their code. This is not a good 
idea. The goal of defining a customized exception class is to ensure that the client 
programmers handle the thrown exceptions of the customized class explicitly in 
their code, to increase the robustness of the whole program. 


W 

Quick 

CHECK 


1. When do we want to define a customized exception class? 

2. Should a customized exception class be a checked or unchecked exception? 


8.6 Assertions 

In this section we will describe a Java assertion and explain how to use it effec¬ 
tively in our programs. A Java assertion is a language feature we use to detect 
logical errors in a program. We will illustrate the key points with a very simple 
class that includes a logical error. Because the sample class is simple, the use of 
assertion may not seem so helpful. Keep in mind that this class is for illustrative 
purposes only. The real benefit of using the assertion feature becomes obvious when 
the program logic gets more complex and the number of classes in the program 
increases. 

H ere's a bank account class that al lows withdrawals and deposits. There's one 
logical error in the class: 

class Bank Ac count { 

private double balance; 

public BankAcco u nt ( do ubIe i n i ti a I BaI ance ) { 
balance = initialBalance; 

} 
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public void deposit(double amount) { 
double oldBalance = balance; 

bal ance - = amount; 

should add the amount. 

assert balance > oldBalance; 

} 

public void wi t hdr aw( doubl e amount) { 
doubl e oldBalance = balance; 

balance - = a mount; 

If this boolean expression 

results in false, then an assert balance < ol dBal ance; 

AssertionError is thrown. } 

public double get Bal ance ( ) { 
return balance; 

} 

} 

Notice the two occurences of the reserved word assert in the class definition. 
The syntax for the assert statement is 

assert <booI ean expressi on> ; 

where <boolean expression> represents the condition that must be true if the code 
is working correctly. When the statement is executed, the <boolean expression> is 
evaluated. If it results in true, then the normal execution of the program continues. 
Otherwise, an AssertionError (subclass of Error) is thrown. 

In this example, we want to assert that balance is more than oldBalance when 
we deposit and less than oldBalance when we withdraw, so we write 

assert balance > oldBalance; 


and 


assert balance < oldBalance; 

at the end of the deposit and withdraw methods, respectively. 

Now let's see what happens when we use this BankAccount class in our pro¬ 
gram. Here's a simplistic main class to test the BankAccount class: 

import javax.swing,*; 
class Ch8TestAssertMain { 

public static void main(String[] args) { 

BankAccount acct = new BankAccount ( 2 0 0 ) ; 
acct. deposi t ( 25) ; 

System, out. pri ntl n ( 

“Current Balance: " + acct. getBal ance()); 

} 

} 
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To run this program with the assertion feature enabled, we must include the 
designation -ea as follows: 

java - ea Ch8TestAssertMain 

[Note: For mostjava IDE, you specify this option in the Preference dialog. Please 
consult your Java IDE for details.) 

If we do not provide the -ea option, then the program is executed without 
checking the assertions. When do we ever want to ignore the assertions we inten¬ 
tionally included in the program? Checking all assertions included in the program 
can be quite costly. By having an option of enabling or disabling the assertions, we 
can choose to enable the assertions while developing and testing the program and 
disable them once the program is fully developed and tested. 


iThings to Remember 



To run the program with assertions enabled, use 
java - ea <main cl a s s > 


With the assert statements enabled, executing the chSTestAssertMain main 
class will result in the following error message: 

Exception in thread "main" j ava.Iang.Asserti onError 
at BankAccount. deposit(BankAccount. j ava: 13) 
at Ch8TestAssertMai n. mai n( Ch8TestAssertMai n.j ava: 34) 

The error message indicates an AssertionError is thrown at line 13 (the actual line 
number would be different if the source code included comments) of the Bank- 
Account class, which is the assert statement 

assert balance > oldBalance; 

We can use the second form of the assert statement to provide a customized 
error message. The syntax for the second form is 

assert < b o oI e a n expression > : <expressi on>; 

where <expression> represents the value that is passed as an argument to the con¬ 
structor of the AssertionError class. The value serves as the detailed message of a 
thrown error. For example, using the second form, we can rewrite the deposit 
method as 

public void deposit(double amount) { 
doubl e oldBalance = balance; 

balance - = a mount; 
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assert balance > oldBalance : 

“Serious Error -- balance becomes less" + 

"after deposit"; 

} 

With this modified deposit method, the error message will be 

Exception in thread "main" j ava,I ang.Asserti onError: 

Serious Error -- balance becomes less after deposit 
at BankAccount. deposi t(BankAccount.j ava:14) 
at Ch8TestAssert Mai n. mai n( Ch8TestAssert Mai n.j ava: 34) 

Encountering this error message during the development, we are made aware 
of the existence of a bug in the program. Without the assertion feature, we may not 
be able to detect the bug until very late in the development, or we may not be able 
to detect it at all. 

Again, for a small class such as BankAccount, the benefit of using assertions 
may not be obvious. However, in designing and building classes that solve diffi¬ 
cult and complex problems, effective use of assertions can be an indispensable aid, 
especially when it is combined with a full set of testing. We will be seeing more 
examples of assertions (and exceptions, also) in the later sample code. 


postcondition 

assertion 

precondition 

assertion 

control flow 
invariant 


Types of Assertions 

The type of assertion we see in the withdraw and deposit methods is called a 
posbooncStionassertion. This assertion checks for a condition that must be true after 
a method is executed. Opposite to the postcondition assertion is a ndtion 
assertion, a checking of condition that must be true before a method is executed. 
The third type of assertion is called a control fbw invariant Consider the foil owing 
switch statement. It adds the appropriate fee to the tuition based on whether the 
student is a dorm resident or a dorm resident or a commuter. 


s wi t c h ( 

resi denceType) 

{ 

case 

COMMUTER: 

total F 



break; 

case 

DORM_ RESI DENT: 

total F 



break; 


} 


ee = tuition + parkingFee; 
ee = tuition + roomAndBoard; 


Now every student must be a dorm resident or a commuter, so if the variable resi- 
denceType has a value other than commuter or dorm_resident, then there's a 
bug somewhere. To detect such bug, we can rewrite the statement as 


switch (resi denceType) { 

case COMMUTER: total Fee = tuition + parkingFee; 

break; 
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case D0RM_RESI DENT: total Fee = tuition + roomAndBoard; 

break; 

def a u 11 : assertfalse: 

“Value of resi denceType " + 
"is invalid, Value = " + 
resi denceType; 

} 

This statement documents the fact that the default case should never be executed 
when the program is running correctly. This is called a control flow invariant 
because the control must flow invariably to one of the two cases. Alternatively, we 
can place an assertion before the switch statement as 


assert (resi denceType == COMMUTER || 

resi denctType == DOR M_ R E S I DENT) : 

"Value of resi denceType is invalid. Value = " + 
resi denceType; 

switch (resi denceType) { 

case COMMUTER: total Fee = tuition + parkingFee; 

break; 


} 


case D0RM_RESI DENT: total Fee 

break; 


tuition + roomAndBoard; 


Differentiating Assertions and Exceptions 

Because both the assertion and the exception mechanisms are intended to improve 
the program reliability, their use is often mixed up. For example, if we are not 
attentive, we could end up using the assertion feature wrongly in places where 
exceptionhandling routines should be used. Consider the foil owing case. In defining 
the deposit and the withdraw methods, we did not bother to check the value of the 
parameter (for the sake of a simplified class definition). The passed amount must 
be greater than zero for the methods to work correctly. How shall we include such 
testing? One possibility (a wrong approach) is to use the assertion feature as (we 
only show the withdraw method). 

public void wi thdraw(doubl e amount) { 
assert a mount > 0; 
doubl e oldBalance = balance; 
balance - = a mount; 
assert balance < oldBalance; 

} 
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This is not a correct use of assertions. We should not use the assertion feature 
to ensure the validity of an argument. In principle, we use assertions to detect the 
internal programming errors, and we use exceptions to notify the client program¬ 
mers of the misuse of our classes. The BankAccount class is intended as a service 
class used by many different programs. It is the responsibility of the client pro¬ 
grammers to pass the valid arguments. If they don't, then wethrow an exception to 
notify them of the misuse. Another problem is that assertions can be enabled or dis¬ 
abled when the program is run. But the validity checking of the arguments should 
never be disabled. 



ings to Remember 


Use assertions to detect internal errors. Use exceptions to notify the client program¬ 
mers of the misuse of our class. 


The correct way to implement the methods is as follows (only the withdraw 
method is shown here): 


public void wi t hdraw( doubl e amount) 

throws I I I egal ArgumentExcepti on { 


i f 


} 


(amount <= 0) { 

throw new I I I egal ArgumentExcepti on( 

“A mo u n t must be positive"); 


double oldBalance = balance; 


balance - = amount; 


assert balance < oldBalance; 

} 


W 

Quick 

CHECK 


1. Why is the following code wrong? 

public void d o Wo r k ( i n t num) { 
assert num > 0; 

total += n u m; 


2. N ame three types of assertions. 
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8.7 Sample Development 


Keyless Entry System 

We will develop a program that simulates a secure keyless entry system for a dormi¬ 
tory. Inside the entrance hall of a dorm, there is an entry system where the dorm resi¬ 
dents must enter their names, room numbers, and passwords. Upon entry of valid data, 
the system will unlock the inner door that leads to the dorm's living quarters. To im¬ 
plement this program, two helper classes are provided. The Door class simulates un¬ 
locking of the inner door.The Dorm class manages resident information. An instance of 
the Dorm class is capable of adding and deleting resident information, reading and 
saving resident information from and to a file, and retrieving information if given the 
resident's name. We can verify the validity of the entered data by checking them 
against the information kept by a Dorm object. 



We can turn our simulation program into a real one by replacing the Door class 
with a class that actually controls the door. Java provides a mechanism called Java 
Native Interface (JNI) which can be used to embed a link to a low-level device dri¬ 
ver code, so calling the open method actually unlocks the door. 


Problem Statement 

Implement a sentry program that asks for three pieces of information: resident's 
name, room number, and a password. A password is any sequence of 8 or more 
characters and is unique to an individual dorm resident. If everything matches, 
then the system unlocks and opens the door. \Ne assume no two residents have 
the same name. Use the provided support classes Door and Dorm. 

Overall Plan 

To provide a complete system, we actually have to write two separate programs. The 
first one is the administrative module for adding, removing, and updating the resident 
information.The second is the user module that interacts with the residents. Figure 8.8 
shows the program diagrams for the two modules. 

In this section, we implement the user module.The administrative module is left 
as an exercise. To begin our development effort, we must first find out the capabilities 
of the Dorm and Door classes. Also, for us to implement the class correctly, we need the 
specification of the Resident class. 

Resident 

The Resident class maintains information on individual dorm residents. We will be deal¬ 
ing with many instances of this class in the program. A password assigned to a resident 
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8.7 Sample Development— continued 





A helper class 
provided to us 


~71 A class we 
U\ implement 


O One or more classes 
we implement 


Figure 8.8 Program diagrams for the user and administrative modules. Notice the same Dorm and 
Resident classes are used in both programs. User and administrative modules will include one or more 
classes (at least one is programmer-defined). 


must be a sequence of 8 or more characters. For this class to work properly with the Dorm 
class, the class must include these public methods: 


Public Methods of R e s i dent 

public Resident! ) 

Default constructor that creates a R e s i dent object with name 
= "unassigned" room ="000" and id ="XY12#$ab'( 
public Resi dent ( St r i ng name, String room, String password) 

throws I I I egal ArgumentExcepti on 
Creates a R e s i dent object with the passed values. 

I I I egal ArgumentExcepti on is thrown when the given password has less 
than four or more than eight characters, 
public void setNa me (String name) 

Assigns the name. 

public void setPassword ( Str i ng id) 

throws I I IegalArgumentExcepti on 
Assigns the password. I I I egal ArgumentExcepti on is thrown when the 
given password has less than four or more than eight characters. 
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public void set Room( St r i ng room) 
Assigns the room, 
public String get N a me ( ) 

Returns the name. 

public String getPassWord) ) 
Returns the password, 
public String get R o o m( ) 

Returns the room number. 


One important restriction to the Resident class is the requirement for the class to 
implement the Serializable interface. Because the Resident objects are saved to a file, 
Java requires the class definition to include the phrase implements Serializable as 

import j a v a. i o. *; 

class Resident implements Serializable { 


} 



| on 

Might 
Want to 
Know 


Details on the significance of the clause implements Serializable will be given 
when we discuss the file input and output in Chapter 12. 


Remembering all those passwords for the laptop, school portal, Yahoo! account, and others 
can be quite tedious and daunting. But using an easy-to-remember password such as your 
birthday or the name of your childhood friend is not a good idea because it is not secure. 
Dictionary words, proper nouns, or simply attaching numbers to the words are not secure 
either. They can be compromised quite easily by those unscrupulous souls using password 
cracking tools. To improve its security, include at least one (preferably two) of each of the 
following characters in your password: 

• Uppercase letters (A,B,C,...) 

• Lowercase letters (a,b,c,...) 

• Digits (0,1,2,...) 

• Symbols (#,$,(§>,...) 

Your password should include a minimum of six characters. You can find out more about 
password security at 

http://www.securitystats.com/tools/password.php 

and 

http://www.microsoft.com/protect/yourself/password/create.mspx 



jlinqs to Remember 


For any object we need to save to a file, its class definition must include the phrase 

implements Serializable. 
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Dorm 

The Dorm class is a helper class provided to us. A Dorm object is capable of managing 
a list of Resident objects. It allows the client to add, delete, and retrieve Resident 
objects. In addition, it is capable of saving a list to a file or reading a list from a file. By 
having these file input and output features, our program can work with different lists of 
residents much as a word processor can work with different documents (files).The class 
definition is as follows: 


Public Methods of Do r m 

public Dor m( ) 

Default constructor that creates a Do r m object, 
public Dor m( St r i ng f i I ename) 

Creates a Do r m object with the resident list read from the file with the 
name f i I e n a me . Throws Fi I eNot FoundExcept i on when the designated 
file cannot be found and I OExcepti on when the file cannot be read, 
public void openFi I e(Stri ng filename) 

Reads the resident list from the designated file.Throws 
Fi I eNot FoundExcept i on when the designated file cannot be found and 
I OExcepti on when the file cannot be read, 
public void saveFi I e(Stri ng filename) 

Saves the resident list to the designated file. Throws I OExcepti on when the 
file cannot be saved. 

public void add( Resi dent resident) 

Adds the r e s i dent to the list. Throws I I I egal ArgumentExcepti on 
when a resident with the same name already exists in the list. We do not allow 
duplicate names. Every resident must have a unique name, 
public void del ete(Stri ng name) 

Deletes the designated resident from the list. If no such resident is in the list, 
nothing happens. 

public Resident getResident(String name) 

Returns the Re s i dent object with the given name. Returns n u I I if no 
matching Re si dent is found, 
public String getResidentLi st( ) 

Returns a list of residents asaStri ng. Aline separator is used after each 
resident. For each resident, the list contains his or her name, room number, 
and password. 


Door 

The Door class is another helper class. It simulates the opening of the door. In a real 
control program, a Door object can have an embedded low-level device driver code, 
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so it really opens the door. The class definition is as follows: 



Now let's study the overall design of the program. In addition to the given helper 
classes and the Resident class, what other classes should we define for this program? 
As the number of classes gets larger, we need to plan the classes carefully. For this 
program, we will define a controller class named Ch8EntranceMonitor whose instance 
will manage all other objects. We will set this class as the program's main class.The user 
interface of the program is handled by the InputHandler class. Its instance is used to 
allow the user to enter his or her name, room number, and password. After the required 
input data are entered by the user, a Ch8EntranceMonitor checks the validity of the 
input data with help from a service Dorm object. If the Dorm object confirms the input 
data, the controller then instructs another service object, an instance of Door, to open 
the door. The following is our working design document, and Figure 8.9 is the program 
diagram. 



Figure 8.9 The program diagram for the Ch8EntranceMonitor program. There are two classes in the 
user module. 
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8.7 Sample Development— continued 


Design Document: Ch8Ent r anceMoni tor 

Class 

Purpose 

Ch8Ent ranceMoni tor 

The top-level control object manages other objects in 
the program.This is an instantiable main class. 

Door 

The given predefined class simulates the opening of a 
door. 

Do r m 

The given predefined class maintains a list of 

R e s i dent objects. 

1 nput Handl er 

The user interface class is for handling input routines. 

Resi dent 

An instance of this class models a single resident of a 
dorm. 


develop¬ 
ment steps 


We will implement the user module in three major steps: 

1 . Define the Resident class and explore the Dorm class. Start with a program 
skeleton to test the Resident class. 

2. Define the user interface InputHandler class. Modify the top-level control class 
as necessary. 

3. Finalize the code by making improvements and tying up loose ends. 


Step 1 Development: Program Skeleton 

step 1 Our first task is to find out about the given Dorm class. (The Door class is a very simple 

design simulator class so there's not much to explore.) To be able to test-run the Dorm class, 

we must provide the Resident class, so this will be our first step. The purpose of the 
skeleton main class in this step is to verify the operations of the Dorm class. 

The specification for the Resident class was given to us, so our task is to implement 
it according to the specification. No design work is necessary. When we can interact with 
an instance of the Dorm class correctly, it confirms that our implementation of the 
Resident class is working. To verify the key operations of the Dorm class, the top-level 
supervisor object Ch8EntranceMonitor will open a file and list the contents of the file, 
step 1 code Here's the Resident class: 



Chapter 


Sample Development: Keyless Entry System. 


File: Resident.java 


*1 
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import j a v a. i o. *; 

class Resident implements Serializable { 


private String name; 

private String room; 

private String pass word; 

public Resi dent ( ) { 

thi s(" unassi gned" , " 0 0 0 ", " XY12#$ab" ) ; 

} 

public Resi dent(Stri ng name, String room, String pwd) 
throws I I I egal ArgumentExcepti on { 
s e t N a me ( n a me ) ; 
set Room( room) ; 
s et Pa s s wo r d ( p wd ); 

} 


r 

Data members 

\ 





r 

Constructors 


l 




public String get N a me ( ) { 
return n a me; 

} 

public String get Passwordl ) { 
return pass word; 

} 

public String get R o o m( ) { 
return room; 

} 

public void setNa me (String name) { 
this, na me = name; 

} 

public void setPassword ( Stri ng pwd) { 
i nt length = pwd. length)); 

if (length < 8) { 

throw new I I I egal ArgumentExcepti on(); 

} else { 

this. pass word = pwd; 

} 

} 


( -\ 

Accessors 


( 

Mutators 


public void set R o o m( String room) { 
this. room = room; 

} 
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8.7 Sample Development— continued 


The skeleton main class is defined as follows: 



Chapter 8 Sample Development: Keyless Entry System. (Step 1) 


File: Ch8EntranceMonitor.j ava 

*/ 


import java.util.*; 
import j a v a. i o. *; 

class Ch8Ent ranee Monitor { //Step 1 main class 

private Dor m manager; 

private Scanner scanner; 

public Ch8EntranceMonitor( ) { 

ma na ge r = new Do r m() ; 

scanner = new Scanner! Syst em. in); 

} 


public static void main(String[] args) { 

Ch8 E ntranceMonitor sentry = new Ch8 E ntranceMonitor (); 
sentry. start)); 


public void st ar t ( ) { 
openFi I e( ) ; 

String roster = manager. getResi dentLi st( ); 
System, out, println(roster); 

} 

private void openFiI e ( ) { 

String filename; 

whiIe (true) { 


start 


openFile 


System, out. p r i n 11 n ( " File to open ( 1 x 1 to cancel):"); 
filename = scanner. next(); 


if (filena me. equals! 11 x“)) {//input routine is canceled 
System, out. p r i n 11 n ( " Program is canceled."); 

System, exit(O); 

} 
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} 


try { 

manager. openFi le(fi I ename); 

return; 

} catch (Fi I eNotFoundExcepti on e) { 

System, out. pri ntl n("No such file' 1 ); 

} catch (I OExcepti on e) { 

System, out. pri ntl n (" Error in reading file' 1 ); 


The purpose of step 1 testing is to verify that the Dorm class is used correctly to 
open a file and get the contents of the file. To test it, we need a file that contains the resi¬ 
dent information. A sample test file can be created by executing the following program, 
which we can modify to create other test data files. 


/* 

Chapter 8 Sample Development: Keyless Entry System. 

A simple class to create dummy test data, 

Fi I e: Samp I eCreateResi dentFiI e.j ava 

*/ 

import java,util.*; 
import java.io.*; 

class Sampl eCreateResi dentFiI e { 

public static void mai n(Stri ng[] args) throws I OExcepti on { 
Resident res; 

Dorm ma na ge r = new Do r m( ) ; 


res = new Resident! " 
manager, add(res); 

j o h n " , 

"1-101", 

" 1AB#2! x b" 

res = new Resident!" 
manager.add(res); 

j ava", 

"1-102", 

"XXyy22&#" 

res = new Resident! " 
manager, add(res); 

j i 1 1 " , 

"3-232", 

" ! # D x A 2 a 4" 
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8.7 Sample Development— continued 


res = new Resi dent("j ack", " 3 - 2 3 2 ", "2 %A z 8 #Q m" ) ; 
manager.add(res); 

Scanner scanner = new Scanner(System. in); 

System, out. print Inf" Save to which file:"); 

String filename = scanner, next)); 

manager. saveFi I e(fi I ename); 

System, exit(O); //terminate the program 

} 

} 


Step 2 Development: Create the User Interface 

step2 In the second development step, we will implement the user interface class 

design InputHandler, whose task is to get three pieces of information. The main controller 

Ch8EntranceMonitor will call an InputHandler to get input data. An InputHandler 
will then go through a sequence of getting the three pieces of data. Once the data are 
entered, Ch8EntranceMonitor will ask the InputHandler for these data. The logic of 
Ch8EntranceMonitor can be expressed as follows: 

InputHandler input = new InputHandler!); 


i nput.get I nput( ); 

String name = input.getName!); 

String room = i nput. get Roo mN u mb e r () ; 
String pwd = i nput. getPassword (); 

Given the input data, we can check for the match as 

Dorm ma na ge r = new Do r m( ) ; 


Resident res = manager. getResi dent( name); 
if (res == null) { 

System, out. println!" Invalid Entry"); 
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} else if ( res. getName () , equa I s ( name ) && 
r es. get Room)) , equ a I s ( r oom) && 
res. get Password! ). equal s( password) ) { 

door. open( ) ; 

} else { 

System, out,println ("Invalid Entry"); 

} 


step 2 code 


The getlnput method of the InputHandler class calls the scanner three times to 
get the name, room, and password. Each input is recorded in the corresponding data 
member. The accessors, such as getName, will simply return the value of the requested 
data member. 

We will list first the InputHandler class and then the modified Ch8Entrance- 
Monitor class. Here's the InputHandler class: 



Chapter 8 Sample Development: Keyless Entry System 
File: Input Handler.java 

*1 

import java,util.*; 
class InputHandler { 

private static final String BLANK = 

private String name; 
private String room; 
private String pwd; 
private Scanner scanner; 

public InputHandler) ) { 

name = BLANK; 
room = BLANK; 
pwd = BLANK; 

scanner = new Scanner(System. in); 

} 

public void get I nput ( ) { 

System, out. p r i n t ( " E n t e r N a me: " ) ; 
name = scanner, next ( ) ; 

System, out. print! "Enter Room No.:"); 
room = scanner, next!); 

System, out. pri nt (" Enter Password: "); 
pwd = scanner. next!); 


' \ 

Data members 





getlnput 


J 
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8.7 Sample Development— continued 


Accessors 


return n a me; 

} 

public String get R o o m( ) { 
return room; 

} 

public String get Passwor d( ) { 
return p wd; 

} 

} 


public String get N a me ( ) { 


The main class is now modified to control an InputHandler object and to check en¬ 
tered information as the resident list maintained by a Dorm object. Here's the step 2 

Ch8EntranceMonitor class: 



Chapter 8 Sample Development: Keyless Entry System. 
File: Ch8EntranceMonitor.j ava (Step 2) 

*/ 

import java,util.*; 
import j a v a. i o. *; 

class Ch8Ent ranceMonit or { 

private Dorm manager; 

private Door door; 

private InputHandler input; 

private Scanner scanner; 

public Ch8EntranceMonitor( ) { 

manager = new Dorm(); 
scanner = new Scanner(System. in); 
input = new InputHandler!); 
door = new Door () ; 

} 


Data members 


( \ 

Constructors 
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public static void ma i n ( S t r i ng [ 1 ar gs ) { 

Ch8E ntranceMoni tor sentry = new Ch8E ntranceMoni tor () ; 
sentry, start)); 


public void start) ) { 
openFiI e( ) ; 

String roster = manager. getResi dentLi st(); //TEMP 
System, out, pri ntl n(roster); II TEMP 
p r oc es s I n put Dat a ( ); 



private void openFiI e ( ) { 

String f i I ename; openFile 

whiIe (true) { 

System, out. println)" File to open ( 1 x' to cancel):"); 
filename = scanner. next)); 


if (filena me, equals) "x")) {//input routine is canceled 
System, out. println) "Program is canceled."); 

System, exi t(0); 

} 

try { 

manager. openFi I e(fi I ename); 

return; 


} catch ( F i I eNo tF o u ndEx c eption e) { 

System, out. println) "No such file"); 

} catch (lOException e) { 

System, out. println) "Error in reading file"); 

} 

} 

} 

private void processI nputData ( ) { 

String na me, room, p wd; 

whiIe (true) { 

i nput,get I nput( ); 

name = input.getNa me)); 
room = input. getRoom)); 
pwd = input.getPass word)); 


processInputData 
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8.7 Sample Development— continued 



v a 1 i d a t 

e ( n a 

me, r o o rr 

l, p wd ) ; 



} 







ate 

void va 

1 i da 

t e(St r i n 

g n a me, 

St ri ng 

r oi 

Res i 

dent re 

s = 

ma n a g e r. 

get Resi 

dent ( na 

me ) 

if ( 

res = = 

nul 1 

) { 





System. 

out. 

p r i n 11 n ( 

"1 n v a 1 i 

d Entry 

"); 

} el 

seif ( 

res. 

g e t N a me ( 

). equal 

s ( n a me ) 

&& 



res. 

get R o o m( 

). equal 

s ( r o o m) 

&& 



res. 

get Pas s wor d(). e 

q ua1 s ( p 

ass’ 


door. op 

en() 

: 




} el 

se { 







System. 

out. 

pr i nt 1 n( 

“1 n v a 1 i 

d Entry 



} 

} 

} 


i ng password) { 


validate 


{ 


Notice that the loop inside the processInputData method is an infinite loop. In 
other words, when the program starts, it will execute indefinitely. To terminate such a 
program, you must either close the Command window or select an appropriate menu 
choice (or click on a toolbar icon) in your Java IDE. We will discuss another way to ter¬ 
minate the program in step 3. 

The purpose of step 2 testing is to verify the correct behavior of an InputHandler 
object. We need to test both successful and unsuccessful cases. We must verify that the 
door is in fact opened when valid information is entered. We must also verify that the 
error message is displayed when there's an error in input. We should test invalid cases 
such as entering nonexistent name, corrent name but wrong password, not entering all 
information,and so forth. 

Step 3 Development: Improve and Finalize 

There are several key improvements we can make to the program. The first and foremost 
is the improved user interface. Instead of getting three pieces of data individually by 
using a scanner, it would be nicer to have a frame window such as the one shown in 
Figure 8.10, where the user can enter all three pieces of information. We will describe how 
to develop such a frame window in Chapter 14. 
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Another improvement is to allow the administrator to terminate the program by 
entering special code. This is left as an exercise. 



Figure 8.10 A frame window that allows the user to enter the three pieces of information together. 
Notice the input entered for the password is displayed back to the user as a sequence of asterisks. 


Summary 


Two techniques to improve program reliability are exception handling and 
assertion. 

Exception handling is another type of control flow. 

A n exception represents an error condition, and when it occurs, we say an 
exception is thrown. 

A thrown exception must be handled by either catching it or propagating it to 
other methods. 

If the program does include code to handle the thrown exceptions, then the 
system will handle them. 

A single method can be both a catcher and a propagator of an exception. 

The standard classes described or used in this chapter are 

Throwable RuntimeException 

Error HlegalArgumentException 

Exception InputMismatchException 

lOException 

The assertion feature is available from Java 2 SDK 1.4. You must use this or 
the later version of the compiler to use assertions in the program. 

The assertion feature is used to detect internal logic errors. 
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n c e p t s 

exceptions 

exception hierarchy 

try-catch 

programmer-defined exceptions 

finally 

assertions 

throws 

precondition assertions 

throw 

postcondition assertions 


Review Exercises 

1. Determine the output of the foil owing code when the input is (a) -1, (b) 0, 
and (c) 12XY. 


Scanner scanner = new Scanner ( System, in); 

try { 

int num = scanner, n e x tI n t ( ); 
if ( num ! = 0) { 

throw new Exception! “Not zero"); 

} 

System, out. println!" I'm happy with the input.' 1 ); 
} catch (Input Mi smatchExcepti on e) { 

System, out. println! "Invalid Entry"); 

} catch (Exception e) { 

System, out. println! "Error: "+ e,get Message!)); 


2. Determine the output of the foil owing code when the input is (a) -1, (b) 0, 
and (c) 12 XY. This is the same question as Exercise 1, but the code here has 
the finally clause. 

Scanner scanner = new Scanner ( System, in); 

try { 

int num = scanner, next I nt(); 
if ( num ! = 0) { 

throw new Exception! "Not zero"); 

} 

System, out. println! "I'm happy with the input."); 

} catch (Input Mi smatchExcepti on e) { 

System, out. println! "Invalid Entry"); 
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} catch (Exception e) { 

System, out. p r i n 11 n (" Error: " + e.get Message()); 

} f i nal I y { 

System, out. p r i n 11 n (" Finally Clause Executed' 1 ); 

} 

3. Why is the following code not a good use of the assertion? 
publ i c voi d c o mp u t e { i nt s i z e ) { 
assert size > 0; 

//computation code comes here 

} 


4. M odify the following code by adding the assert statement. The value of 
gender is either male or female if the program is running correctly. 


switch (gender ) { 
case MALE: 


case FEMALE 


} 


total Fee 

break; 

total Fee 

break 


tuition + parkingFee; 
tuition + roomAndBoard; 


5. M odify the following method by adding the assert statement. Assume the 
variable factor is a data member of the class. 

publ i c doubl e c o mp u t e ( doubl e v a I u e ) { 
return (value * value) / factor; 

} 


Level 1 Programming Exercises ★ 

6. W hen you run ch8TestAgelnputVer4 and enter a negative number, you 
will get an error message: "Sorry, you do not qualify to enter the junior 
competition." However, when a negative number is entered, it is more 
appropriate to say "Illegal value: negative age is invalid." M odify the 
Testinputver4 class so that an appropriate error message is displayed for 
a negative input value. 

7. M odify the getinput method of the inputHandler class from Section 8.7 so 
that the method will throw an exception when a blank string (a sequence of 
one or more blank spaces) is entered for the name, room, or password. 
Define a new exception class EmptyinputException. 

8. The user module of the keyless entry system in Section 8.7 does not include 
any logic to terminate the program. M odify the program so it will terminate 
when the values Admin, X123, and $maTrix%TwO$ are entered for name, 
room, and password, respectively. 
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Level 2 Programming Exercises ★★ 

9. Extend the Fraction class from Chapter 7 by incorporating exception 
handling and assertions. 

10. Extend the Loan class from Chapter 4 Sample Development section by in¬ 
corporating exception handling and assertions where appropriate. Adjust the 
LoanCalculator class accordingly to use the modified Loan class. 

Development Exercises 

For the following exercises, use the incremental development methodology to 
implement the program. For each exercise, identify the program tasks, create 
a design document with class descriptions, and draw the program diagram. 

M ap out the development steps at the start. Present any design alternatives and 
justify your selection. Be sure to perform adequate testing at the end of each 
development step. 

11. In the sample development, we developed the user module of the keyless 
entry system. For this exercise, implement the administrative modulethat 
allows the system administrator to add and delete Resident objects and 
modify information on existing Resident objects. The module will also allow 
the user to open a list from a file and save the list to a file. Is it proper to 
implement the administrative module by using one class? Wouldn't it be 

a better design if we used multiple classes with each class doing a single, 
well-defined task? 

12. Write an application that maintains the membership lists of five social clubs 
in a dormitory. The five social clubs are the Computer Science Club, Biology 
Club, Billiard Club, No Sleep Club, and WineTasting Club. Use the Dorm 
class to manage the membership lists. Members of the social clubs are 
Resident objects of the dorm. U se a separate file to store the membership 
list for each club. Allow the user to add, delete, and modify members of 
each club. 
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I I — ««• 

Objectives 


After you have read and studied this chapter,you 
should be able to 

• Declare and manipulate data of the char type. 

• Write string processing programs, using 

String, StringBuilder, and StringBuffer 

objects. 

• Specify regular expressions for searching a 
pattern in a string. 

• Differentiate the String, StringBuilder, and 
StringBuffer classes and use the correct class 
in solving a given task. 

• Tell the difference between equality and 
equivalence testings for String objects. 

• Use the Pattern and Matcher classes. 
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Introduction 



arly computers in the 1940s and 1950s were more like gigantic calculators because 
they were used primarily for numerical computation. However, as computers have 
evolved to possess more computational power, our use of computers is no longer 
limited to numerical computation. Today we use computers for processing infor¬ 
mation of diverse types. In fact, most application software today such as Web 
browsers, word processors, database management systems, presentation software, 
and graphics design software is not intended specifically for number crunching. 
These programs still perform numerical computation, but their primary data are 
text, graphics, video, and other nonnumerical data. We have already seen examples 
of nonnumerical data processing. We introduced the string class and string process¬ 
ing in Chapter 2. A nonnumerical data type called boolean was used in Chapters 5 
and 6. In this chapter, we will delve more deeply into the string class and present 
advanced string processing. We will also introduce the char data type for represent¬ 
ing a single character and the stringBuffer class for an efficient operation on a 
certain type of string processing. 


char 


ASCII 


9.1 


Characters 


In Java single characters are represented by using the data type char. Character 
constants are written as symbols enclosed in single quotes, for example, 'a', 'X', 
and '5'. Just as we use different formats to represent integers and real numbers 
using Os and Is in computer memory, we use specific coding of Os and Is to repre¬ 
sent single characters. For example, we may assign 1 to represent 'A' and 2 to repre¬ 
sent 'B'. We can assign codes similarly to lowercase letters, punctuation marks, 
digits, and other special symbols. In the early days of computing, different com¬ 
puters used not only different coding schemes but also different character sets. For 
example, one computer could represent the symbol % while other computers 
could not. Individualized coding schemes did not allow computers to share infor¬ 
mation. Documents created by using one scheme are complete gibberish if we 
try to read these documents by using another scheme. To avoid this problem, U.S. 
computer manufacturers devised several coding schemes. One of the coding 
schemes widely used today is ASCII (American Standard Code for Information 
Interchange). We pronounce ASCII "as ke." Table 9.1 shows the 128 standard 
ASCII codes. 

Adding the row and column indexes in Table 9.1 gives you the ASCII code 
for a given character. For example, the value 87 is the ASCII code for the char¬ 
acter 'w\ Not all characters in the table are printable. ASCII codes 0 through 31 
and 127 are nonprintable control characters. For example, ASCII code 7 is the 
bell (the computer beeps when you send this character to output), and code 9 
is the tab. 


www.it-ebooks.info 





9.1 Characters 497 



When we use a word processor to create a document, the file that contains the 
document includes not only the contents but also the formatting information. 
Since each software company uses its own coding scheme for storing this informa¬ 
tion, we have to use the same word processor to open the document. Often it is 
even worse. We cannot open a document created by a newer version of the same 
word processor with an older version. If we just want to exchange the text of a 
document, then we can convert it to ASCII format. Any word processor can open 
and save ASCII files. If we would like to retain the formatting information also, 
we can convert the document, using software such as Adobe Acrobat. This soft¬ 
ware converts a document (including text, formatting, images, etc.) created by 
different word processors to a format called PDF. Anybody with a free Acrobat 
Reader can open a PDF file. Many of the documents available from our website 
are in this PDF format. 


To represent all 128 ASCII codes, we need 7 bits ranging from 000 0000(0) 
to 111 1111 (127). Although 7 bits is enough, ASCII codes occupy 1 byte (8 bits) 
because the byte is the smallest unit of memory you can access. Computer manu¬ 
facturers use the extra bit for other nonstandard symbols (e.g., lines and boxes). 
Using 8 bits, we can represent 256 symbols in total— 128 standard A SC 11 codesand 
128 nonstandard symbols. 


Table 9.1 ascii codes 



0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

0 

nul 

soh 

stx 

etx 

eot 

enq 

ack 

bel 

bs 

ht 

10 

If 

vt 

ff 

cr 

so 

si 

die 

del 

dc2 

dc3 

20 

cd4 

nak 

syn 

etb 

can 

em 

sub 

esc 

fs 

gs 

30 

rs 

us 

sp 

j 

" 

# 

$ 

% 

& 

1 

40 

( 

) 

* 

+ 

, 

- 


/ 

0 

1 

50 

2 

3 

4 

5 

6 

7 

8 

9 


; 

60 

< 

= 

> 

? 

@ 

A 

B 

C 

D 

E 

70 

F 

G 

H 

1 

J 

K 

L 

M 

N 

O 

80 

P 

Q 

R 

S 

T 

U 

V 

W 

X 

Y 

90 

Z 

[ 

\ 

] 

A 



a 

b 

c 

100 

d 

e 

f 

g 

h 

i 

j 

k 

1 

m 

110 

n 

0 

P 

q 

r 

s 

t 

u 

v 

w 

120 

x 

y 

z 

{ 

1 

} 

~ 

del 
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Unicode 


The standard ASCII codes work just fine as long as we are dealing with the 
English language because all letters and punctuation marks used in English are 
included in the ASCII codes. We cannot say the same for other languages. For lan¬ 
guages such as French and German, the additional 128 codes may be used to repre¬ 
sent character symbols not available in standard ASCII. But what about different 
currency symbols? What about non-European languages? Chinese, Japanese, and 
Korean all use different coding schemes to represent their character sets. Eight bits 
is not enough to represent thousands of ideographs. 

To accommodate the character symbols of non-English languages, the 
U ni code Consortium established the Unicode Worldwide Character Standard, com¬ 
monly known simply as Unicode, to support the interchange, processing, and dis¬ 
play of the written texts of diverse languages. The standard currently contains 
34,168 distinct characters, which cover the major languages of the Americas, 
Europe, the M iddle East, Africa, India, Asia, and Pacifica. To accommodate such a 
large number of distinct character symbols, Unicode characters occupy 2 bytes. 
Unicode codes for the character set shown in Table 9.1 are the same as ASCII 
codes. 

J ava, bei ng a I anguage for the I nternet, uses the U ni code standard for repre- 
senting char constants. Although Java uses the Unicode standard internally to store 
characters, to use foreign characters for input and output in our programs, the oper¬ 
ating system and the development tool we use for Java programs must be capable of 
handling the foreign characters. 

Characters are declared and used in a manner similar to data of other types. 
The declaration 

char chi, c h2 = 1 X 1 ; 

declares two char variables chi and ch2 with ch 2 initialized to 'X'. We can display 
the A SC 11 code of a character by converting it to an integer. For example, we can 
execute 


System, out. pri ntl n("ASCI I code of character X is " 

+ ( i nt ) 1 X 1 ) ; 

Conversely, we can see a character by converting its ASCII code to the char data 
type, for example, 

System, out. pri ntl n ( 

"Character with ASCII code 88 is " + ( c h a r ) 8 8 ); 

B ecause the characters have numerical ASCII val ues, we can compare charac¬ 
ters just as we compare integers and real numbers. For example, the comparison 

1 A 1 < 1 c 1 

returns true because the A SC 11 value of 'A' is 65 while that of 'c' is 99. 
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W 

Quick 

CHECK 


String 


charAt 


1. Determine the output of thefollowing statements. 


a. 

System, out 

pr 

nt 

n ( 

char ) 65 

b. 

System, out 

pr 

nt 

n ( 

int) 1 C 1 

c. 

System, out 

pr 

nt 

n ( 

r ); 

d. 

if ( 1 A 1 < 

1 ? 1 

) 




System, 

u t 

pr 

nt 1 

n ( 'A 1 ) 


else 






System, 

u t 

pr 

nt 1 

n ( ' ?' ) 


2. How many distinct characters can you represent by using 8 bits? 

9.2 Strings 

A string is a sequence of characters that is treated as a single value. Instances of the 
String class are used to represent strings in Java. Rudimentary string processing 
was already presented in Chapter 2, using methods such as substring, length, and 
indexOf. In this section we will learn more advanced string processing, using other 
methods of the string class. 

To i ntroduce addi ti onal methods of the string cl ass, we wi 11 go through a num¬ 
ber of common string processing routines. The first is to process a stri ng looking for 
a certai n character or characters. L et's say we want to i nput a person's name and de- 
termine the number of vowels that the name contains. The basic idea is very simple: 

for each character c h in the string { 
if ( ch is a vowel ) { 
inc r ernent the counter 

} 

i 

There are two details we need to know before being able to translate that into actual 
code. First, we need to know how to refer to an individual character in the string. 
Second, we need to know how to determine the size of the string, that is, the num¬ 
ber of characters the string contains, so we can write the boolean expression to stop 
the loop correctly. We know from Chapter 2 that the second task is done by using 
the length method. For the first task, we use charAt. 

We access individual characters of a string by calling the charAt method of 
the string object. For example, to display the individual characters of the string 
Sumatra one at a time, we can write 

String n a me = " S u ma t r a" ; 
int size = na me. length! ); 

for (int i = 0; i < s i z e ; i + + ) { 

System, out, pri ntl nfname. c h a r A t (i )); 

} 

Each character in a string has an index that we use to access the character. We 
use zero-based indexing; that is, the first character has index 0, the second character 
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String name = "Sumatra"; 


0 1 2 3 4 5 6 



name name.charAt(3) 


C \ 

The variable refers to the 

whole string. 

v_ 


y 

T he method returns the 
character at position 3. 


Figure 9.1 An indexed expression is used to refer to individual characters in a string. 


has index 1, the third character has index 2, and so forth. To refer to the first char¬ 
acter of name, for example, we say 

name, charAt(O) 

Since the characters are indexed from o to size-i, we could express the pre¬ 
ceding for loop as 

for (int i =0; i < = size - 1; i + + ) 

However, we will use the first style almost exclusively to be consistent. 

Figure 9.1 illustrates how thecharAt method works. Notice that name refers 
to a string object, and we are calling its charAt method that returns a value of prim¬ 
itive data type char. Strictly speaking, we must say "name is a variable of type 
string whose value is a reference to an instance of string." However, it is more com¬ 
mon to say "x is an instance of y" or "x is a y object." We often shorten it further to 
"x is a y." 



ings to Remember 

If the value of a variable X is a reference to an object of class Y, then we say "X is a Y 
object"or" X is an instance of Y." Frequently, we also say "X is a Y." 


Since string is a class, we can create an instance of a class by using the new 
method. The statements we have been using so far, such as 

String namel = "Kona"; 

String n a me 2; 
n a me 2 = "Espresso"; 

work as a shorthand for 

String namel = new String! "Kona"); 

String n a me 2; 

name2 = new String! "Espresso"); 
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Be aware that this shorthand works for the string class only. M oreover, although the 
difference will not be critical in almost all situations, they are not exactly the same. 
We will discuss the subtle difference between the two in Section 9.5. 

H ere is the code for counting the number of vowels: 



Chapter 9 Sample Program: Count the number of vowels 

in a given string 


File: Ch9CountVowel s.j ava 

*/ 


import java,util.*; 
class Ch9CountVowels { 


} 


public static void main (String!) args) { 

Scanner scanner = new Scanner(System, in); 

scanner. useDeli mi ter( System. getProperty("l i ne. separator")); 

String n a me; 


i nt n u mb e r Of Ch a r a c t e r s , 
vowel Count =0; 

char letter; 


System, out. pri nt(" Wh a t is your n a me ?" ) ; 
name = scanner. next( ); 


number Of Characters = name. length) ); 
for ( i nt i = 0; i < numberOfCharacters; i ++) { 
letter = name. charAt( i ) ; 


1 et t e r 

== ' a' 

j j letter == 1 A 1 

1 et t e r 

== 1 e 1 

| j letter == 1 E 1 

1 et t e r 

== ' 1 ' 

|| letter == 1 1 1 

1 et t e r 

== 1 o' 

|| 1 etter == 1 O' 

1 et t e r 

== ' u' 

|| 1 etter == 1 U' 


vowel Count ++ 

} 

} 


System, out. p r i n 11 n ( n a me + ”, your name has 
vowel Count + " vowel s " ) ; 


} 


+ 
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We can shorten the boolean expression in the if statement by using the 
toUpperCase method of the string class. This method converts every character in a 
string to uppercase. Here's the rewritten code: 



Chapter 9 Sample Program: Count the number of vowels 

in a given string using toUpperCase 


File: Ch9CountVowel s2.j ava 

*/ 

import java.util.*; 

class Ch9CountVowels2 { 

public static void main (String!] a r g s ) { 

Scanner scanner = new Scanner(System. in); 

scanner, use Deli mi ter(Syste m. get Property!" line, separator")); 

String name, n a me Upper; 

i nt n umbe r Of Cha r a c t er s, 

vowel Count =0; 

char letter; 

System, out. pri nt("What is your n a me ?" ) ; 
name = scanner. next( ); 

number Of Characters = name, length! ); 
n a me Upper = name. toUpperCase! ); 

for ( i nt i = 0; i < numberOfCharacters; i ++) { 

letter = name Upper.char At (i); 

if (letter == 1 A 1 | | 
letter == 1 E 1 | j 
letter == 1 I 1 j j 
letter == 1 0 1 | | 
letter == 1 U 1 ) { 

vowel Count ++; 

} 

} 

( n a me + ", your n a me has " + 
vowel Count + " vowels"); 

} 

} 
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toUpperCase 


Skip blank spaces until 
a character that is not a 
blank space is encoun- 
tered.This is the begin¬ 
ning of a word. 

Once the beginning of 
a word is detected, we 
skip nonblank charac¬ 
ters until a blank space 
is encountered.This is 
the end of the word. 


Notice that the original string name is unchanged. A new, converted string is 
returned from the toUpperCase method and assigned to the second string variable 
namellpper. 

Let's try another example. This time we read in a string and count how many 
words the string contains. For this example we consider a word as a sequence of 
characters separated, or deli mi ted, by blank spaces. We treat punctuation marks and 
other symbols as part of a word. Expressing the task in pseudocode, we have the 
following: 

read in a sentence; 

while ( there are mor e characters in the sentence) { 
look for the beginning of the next word; 
now look for the end of this word; 
i ncr ement the word counter; 

} 

We use a while loop here instead of do-while to handle the case when the 
input sentence contains no characters, that is, when it is an empty string. Let's 
implement the routine. Here's our first attempt: 

//Attempt No. 1 

static final char BLANK = 1 1 ; 

Scanner scanner = new ScannerfSystem, in); 

scanner. useDel i mi ter(System. getProperty("l i ne, separator ")); 

i nt index, wordCount, numberOfCharacters; 

System, out. p r i n 11 n (" Enter a sentence: "); 

String sentence = scanner. next ( ); 

numberOfCharacters = sentence, length!); 

i ndex = 0; 

wordCount = 0; 

while (index < numberOfCharacters ) { 

//ignore blank spaces 

while ( sentence. charAt ( i ndex ) == BLANK) { 
i n d e x ++; 

} 

II now locate the end of the word 

while (sentence. charAtfi ndex) != BLANK) { 
i n d e x ++; 

_} jA 

II another word has been found, so increment the counter 

ifftr dCount — 

} 
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This implementation has a problem. The counter variable index is incre¬ 
mented inside the two inner while loops, and this index could become equal to 
numberOfCharacters, which is an error, because the position of the last character 
is numberOf Characters - 1. We need to modify the two while loops SO that index 
will not become larger than numberofcharacters-i. Here's the modified code: 



Chapter 9 Sample Program: Count the number of words 

in a given string 

File: Ch9Count Words, java (Attempt 2) 

*1 

import java.util.*; 

class Ch9Count Words { //Attempt 2 

private static final char BLANK = 1 
public static void main (String!) args) { 

Scanner scanner = new Scanner(System. in); 

scanner. useDel i miter(System. getPropertyl “I i ne, separator ")); 

i nt index, wordCount, numberOf Char acters; 

System, out. p r i n 11 n ( "Enter a sentence: "); 

String sentence = scanner. next ( ); 

number Of Characters = sentence. length) ); 
index =0; 

wordCount = 0; 

while ( index < n u mb e r Of Ch a r a c t e r s ) { 

//ignore blank spaces 

while (index < numberOfCharacters && 

sentence. charAt ( i ndex ) == BLANK) { 

i ndex ++; 

} 

II now locate the end of the word 

while (index < numberOfCharacters && 

sentence. charAt ( i ndex ) != BLANK) { 

i ndex ++; 

} 

//another word is found, so increment the counter 
wo r d Co u n t ++; 


} 
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/ 

s 

s 

} 

} 


out-of-bound 

exception 


/display the result 

ystem. out. pri ntl n( "\n input sentence: " + sentence ); 

ystem. out. pri ntl n( " Word count: " + word Count + " words" ); 


Notice that the order of comparisons in the boolean expression 

index < numberOf Characters 

&& sentence, charAt ( i ndex ) == BLANK 

is critical. If we switch the order to 

sentence.charAt ( i ndex ) == BLANK 

&& index < numberOfCharacters 

and if the last character in the string is a space, then an out-of-bound exception will 
occur because the value of index is a position that does not exist in the string 
sentence. By putting the expression correctly as 

index < n u mb e r Of Ch a r a c t e r s && s e nt e n c e. c ha r At ( i n de x ) != ' ' 

we will not get an out-of-bound exception because the boolean operator && is 
a shortcircuit operator. If the relation index < numberOfCharacters is false, then 
the second half Of the expression sentence.charAT(index) != BLANK will not get 
evaluated. 

There is still a problem with the attempt 2 code. If the sentence ends with one 
or more blank spaces, then the value for wordCount will be 1 more than the actual 
number of words in the sentence. It is left as an exercise to correct this bug (see 
Exercise 15 at the end of the chapter). 

Our third example counts the number of times the word Java occurs in 
the input. The repetition stops when the word stop is read. Lowercase and upper¬ 
case letters are not distinguished when an input word is compared to Java, but 
the word stop for terminating the loop must be in all uppercase letters. Here's the 
pseudocode: 

j avaCount = 0; 

while (true) { 

read in next word ; 

if (word i s " STOP " ) { 

break; 
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} else if ( word is "Java" ignoring cases ) { 
j avaCount ++; 

} 


And here's the actual code. Pay close attention to how the strings are 
compared. 



Chapter 9 Sample Program: 


Count the number of times the word 'java 1 occurs 
in input. Case-insensitive comparison is used here. 

The program termi nates when the word STOP (case-sensitive) 
is entered. 

File: Ch9CountJ ava.j ava 

*1 

import java,util.*; 
class Ch9Countjava { 

public static void main (String!) args) { 

Scanner scanner = new Scanner(System. in); 
i nt j avaCount =0; 

String word; 

whiIe (true) { 

System, out. pri nt("Next word: " ); 
word = scanner, next ( ); 

if ( wo r d, equaI s (" STOP" ) ) { 

break; 

} else if (word, equal si gnoreCase("J ava") ) { 
j avaCount ++; 

} 

} 

System, out. pri ntl n("'J ava' count: " + javaCount ); 

} 

} 
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compareTo 


String comparison is done by two methods— equals and equalsignoreCase— 
whose meanings should be clear from the example. A nother comparison method is 
compareTo. This method compares two string objects strl and str2 as in 

s t r1. co mp a r e T o ( s t r 2 ); 

and returns 0 if they are equal, a negative integer if strl is less than str 2 , and a pos¬ 
itive integer if strl is greater than str 2 . The comparison is based on the lexicographic 
order of Unicode. For example, caffeine is less than latte. Also, the string jaVa is 
less than the string java because the U nicode val ue of v is smaller than the U nicode 
value of v. (See the A SC 11 table, Table 9.1.) 

Some of you may be wondering why we don't say 

if ( word == "STOP" ) 

We can, in fact, use the equality comparison symbol == to compare two string 
objects, but the result is different from the result of the method equals. We will 
explain the difference in Section 9.5. 

Let's try another example, using the substring method we introduced in 
Chapter 2. To refresh our memory, here's how the method works. If str is a string 
object, then the expression 

str. substri ng ( beginlndex, endl ndex ) 

returns a new stri ng that i s a substri ng of str from positi on beginlndex to endindex -1. 
The value of beginlndex must be between 0 and str.lengthO — i, and the value of 
endindex must be between 0 and Str.lengthO. In addition, the value Of beginlndex 
must be less than or equal to the value of endindex. Passing invalid values for 
beginlndex or endindex will result in a runtime error. 

In this example, we print out the words from a given sentence, using one line 
per word. For example, given an input sentence 

1 want to be a java progra mme r 

the code will printout 


wa nt 
t o 
be 
a 

java 

progra mme r 
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This sample code is similar to the previous one that counts the number 
of words in a given sentence. Instead of just counting the words, we need to extract 
the word from the sentence and print it out. Here's how we write the code: 



Chapter 9 Sample Program: 


Extract the words in a given sentence and 
print them, using one line per word. 

File: Ch9ExtractWords. j ava 

*/ 

import java,util.*; 
class Ch9ExtractWords { 

private static final char BLANK = 1 

public static void main (String!) args) { 

Scanner scanner = new Scanner(System. in); 

scanner. useDel i mi ter(System. getProperty("l i ne. separator")); 

i nt index, n u mbe rOfCharact e rs, 
beginldx, endldx; 

String word, sentence; 

System, out.pri nt("l nput: " ); 

Sentence = scanner, next ( ); 

number Of Characters = sentence. length!); 
i ndex = 0; 

while (index < numberOfCharacters ) { 

//ignore leading blank spaces 

while (index < numberOfCharacters && 

sentence. charAt ( i ndex ) == BLANK) { 

i n d e x ++; 

} 

beginldx = index; 

II now locate the end of the word 

while (index < numberOfCharacters && 

sentence. charAt ( i ndex ) != BLANK) { 

i n d e x ++; 

} 
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} 


endldx = index; 

if (beginldx != endldx) { 

//another word is found, extract it fromthe 
II sentence and print it out 

word = sentence.substri ng( beginldx, endldx ); 

System, out. pri ntl n(word); 

} 


N otice the signficance of the test 

if (beginldx ! = endldx) 

in the code. For what kinds of input sentences will the variables beginldx and 
endldx be equal? We'll leave this as an exercise (see Exercise 16 at the end of the 
chapter). 


r— 

Quick 

CHECK 


1. Determine the output of the following code. 

a. String s t r = " P r o g r a mmi n g" ; 
for ( i nt i =0; i <9; i + = 2) { 

System, out. print) str.charAt( i )); 

} 

b. S t r i n g s t r = " Wo r I d Wi d e Web"; 

f or ( i nt i =0; i <10; i ++ ) { 
if ( s t r. c har At (i ) == 1 W 1 ) { 

System, out. pri ntl n( 1 M 1 ); 

} else { 

System, out. print) str.charAt(i) ); 

} 

} 

2. Write a loop that prints out a string in reverse. If the string is Hello, then the 
code outputs olleH. 
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3. Assume two string objects strl and str2 are initialized as follows: 

String strl = " p r o g r a mmi n g" ; 

String s t r 2 = "language"; 

Determine the value of each of the following expressions if they are valid, if 
they are not valid, state the reason why. 

a. s t r 1. c o mp a r e T o ( s t r 2 ) 

b. str2.compareTo( s t r 2 ) 

c. s t r 2. substring! 1, 1 ) 

d. s t r 2. substring! 0, 7 ) 

e. str2. charAtf 11 ) 

f. strl. length) ) + s t r 2. length) ) 

4. W hat is the difference between the two String methods equals and 
equalsIgnoreCase? 


pattern 

matching 


9.3 


Pattern Matching and Regular Expression 


One sample code from Section 9.2 searched for the word Java in a given string. This 
sample code illustrated a very simplified version of a well-known problem called 
pattern matching. Word processor features such as finding a text and replacing a 
text with another text are two specialized cases of a pattern-matching problem. 


The matches Method 

Let's begin with the matches method from the string class. In its simplest form, it 
looks very similar to the equals method. For example, given a string str, the two 
statements 

s t r. e q u a I s ( " H e I I o " ) ; 
str. ma t c h e s (" H e I I o" ) ; 

both evaluate to true if str is the string Hello. However, they are not truly equivalent, 
because, uni i ke equals, the argument to the matches method can be a pattern, a fea¬ 
ture that brings great flexibility and power to the matches method. 

Suppose we assign a three-digit code to all incoming students. The first digit 
represents the major, and 5 stands for the computer science major. The second digit 
represents the home state: 1 is for in-state students, 2 is for out-of-state students, and 
3 is for foreign students. And the third digit represents the residence of the student. 
On-campus dormitories are represented by digits from 1 through 7. Students living 
off campus are represented by digit 8. For example, the val id encodi ngs for students 
majoring in computer science and living off campus are 518, 528, and 538. The 
valid three-digit code for computer science majors living in one of the on-campus 
dormitories can be expressed succinctly as 

5[ 123] [ l- 7] 
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regular 

expression 


and here's how we interpret the pattern: 

third 
digit 

/ 

[ 1 - 7 ] 

_I It must be any 

I digit from 1 to 7. 

I It must be 
I 1,2, or 3. 

The pattern is called a regular expression that allows us to denote a large (often in¬ 
finite) set of words succinctly. The "word" is composed of any sequence of symbols 
and is not limited to alphabets. The brackets [ ] are used here to represent choices, 
so [123] means i, 2, or 3. We can use the notation for alphabets also. For example, 
[a Be] means a, B, ore. Notice the notation is case-sensitive. The hyphen in the brack¬ 
ets shows the range, so [i-7] means any digit from i to 7. If we want to allow any 
lowercase letter, then the regular expression will be [a-z]. The hat symbol A is used 
for negation. For example, [ A abc] means any character except a, b, or c. Notice that 
this expression does not restrict the character to lowercase letters; it can be any 
character including digits and symbols. To refer to all lowercase letters except a, b, 
or c, the correct expression is [a-z&&[ A abc]]. The double ampersand represents an 
intersection. FI ere are more examples: 


first second 
digit digit 

\ I 

5 [ 123 ] 

It must be 5 for 

the computer - 

science majors. 


Expression 

Description 

[013] 

A single digit 0,1, or 3 . 

[ 0 - 9 ] [ 0 - 9 ] 

Any two-digit number from 0 0 to 9 9 . 

A [ 0 - 4 ] b [ 0 5 ] 

A string that consists of four characters. The first 
character is A .The second character is 0,1,2,3 ,or 4 . 

The third character is b . And the last character is 
either 0 or 5. 

[0-9&&[” 4 5 6 7 ]] 

A single digit that is 0,1,2,3,8 ,or 9 . 

[a-zO-9] 

A single character that is either a lowercase letter or a 
digit. 


We can use repetition symbols * or + to designate a sequence of unbounded 
length. The symbol * means o or more times, and the symbol + means i or more 
times. Let's try an example using a repetition symbol. Remember the definition 
for a valid Java identifier? We define it as a seqence of alphanumeric characters, 
underscores, and dollar signs, with the first character being an alphabet. In regular 
expression, we can state this definition as 

[ a- z A- Z] [ a- z A- ZO- 9_$] * 
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Let's write a short program that will input a word and determine whether it is 
a valid J ava identifier. The program stops when the word entered is stop. Here's the 
program: 



* 

Chapter 9 Sample Program: Checks whether the input 
string is a valid identifier. 


File: Ch9MatchJ aval dentifier.j ava 

*/ 


import java.util.*; 

class C h 9 Ma tc hj aval dentifi er { 

private static final String STOP = “STOP"; 

private static final String VALID = "Valid java identifier"; 

private static final String INVALID = “Not a valid java identifier": 

private static final String VALID IDENTIFIER PATTERN 

= "[a- zA-Z][a-zA-Z0-9_$]*" ; 

public static void main (String!] args) { 

Scanner scanner = new Scanner (System, in); 

String str, reply; 

whiIe (true) { 

System, out.print ("Identifier: "); 
str = scanner. next) ); 

if (str. equal s ( STOP) ) break; 

if (str. matches(VALI D IDENTIFIER PATTERN)) { 
reply = VALID; 

} else { 

reply = I NVALI D; 

} 

S y s t e m, o u t. p r i n 11 n ( s t r + ": " + reply + " \ n" ) ; 

} 

} 

} 


It is also possible to designate a sequence of fixed length. For example, to spec¬ 
ify four-digit numbers, we write [0-9]{4}. The number in the braces { and } denotes 
the number of repetitions. We can specify the minimum and maximum numbers of 
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repetitions also. Here are the rules: 


Expression 

Description 

X{N} 

Repeat X exactly N times, where X is a regular 
expression for a single character. 

X{N,} 

Repeat X at least N times. 

X{N,M} 

Repeat X at least N but no more than M times. 


Here's an example of using a sequence of fixed length. Suppose we want to 
determi ne whether the input string represents a valid phone number that folIows the 
pattern of 

xxx-xxx-xxxx 

where x is a single digit from o through 9. The following is a program that inputs a 
string continually and replies whether the input string conforms to the pattern. The 
program terminates when a single digit o is entered. Structurally this program is 
identical to the ch9MatchJavaidentifier class. Here’s the program: 


W 

I * 

Chapter 9 Sample Program: Checks whether the input 
string conforms to the phone number 
pattern xxx-xxx-xxxx. 

File: Ch9MatchPhoneNumber.j ava 

*/ 

import java,util.*; 

class Ch9MatchPhoneNumber { 

private static final String STOP = "0"; 

private static final String VALID = "Valid phone number"; 

private static final String INVALID = "Not a valid phone number": 

private static final String VALI D_PH0NE_PATTERN 

= " [ 0 - 9 ] {3} - [ 0 - 9 ] {3} - [ 0 - 9 ] {4}"; 

public static void main (String!] args) { 

Scanner scanner = new Scanner (System, in); 

String phoneStr, reply; 

whiIe (true) { 

System, out.print ("Phone#: "); 
phoneStr = scanner, next ( ); 


www.it-ebooks.info 







514 Chapter 9 


Characters and Strings 


if ( phoneStr.equal s( STOP) ) break; 

if ( phoneStr. matches(VALI D PHONE PATTERN)) { 
reply = VALI D; 

} else { 

reply = I NVALI D; 

} 

System, out. pri ntl nfphoneStr + " + reply + " \ n" ) ; 

} 

} 

} 


Suppose, with the proliferation of cell phones, the number of digits used for a 
prefix increases from three to four in major cities. (In fact, Tokyo now uses a four¬ 
digit prefix. Phenomenal growth in the use of fax machines in both offices and 
homes caused the increase from three to four digits.) The valid format for phone 
numbers then becomes 

xxx-xxx-xxxx or xxx-xxxx-xxxx 

This change can be handled effortlessly by defining valid_phone_pattern as 

private static final String VALI D_PHONE_PATTERN 

= " [ 0 - 9 ] {3} - [ 0 - 9 ] {3, 4 } - [ 0 - 9 T { 4}" ; “ 

This is the power of regular expression and pattern-matching methods. All we 
need to do is to make one simple adjustment to the regular expression. No other 
changes are made to the program. Had we written the program without using the 
pattern-matching technique (i.e., written the program using repetition control to test 
the first to the last character individually), changing the code to handle both a three- 
digit and a four-digit prefix requires substantially greater effort. 

The period symbol (.) is used to match any character except a line terminator 
such as\n or\r. (By using the Pattern class, we can make it match a line terminator 
also. We discuss more details on the Pattern class later.) We can use the period sym¬ 
bol with the zero-or-more-times notation * to check if a given string contains a 
sequence of characters we are looking for. For example, suppose a string object 
document holds the content of some document, and we want to check if the phrase 
"zen of objects" is in it. We can do it as follows: 

String document; 

document = ...; //assign text to 'document' 

if (document, matches!". *zen of objects.*") { 

System, out, pri ntl n ( “ Found"); 
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} else { 

System, out, pri ntl n (" Not found"); 

} 

The brackets [ and ] are used for expressing a range of choices for a single 
character. If we need to express a range of choices for multiple characters, then we 
use the parentheses and the vertical bar. For example, if we search for the word 
maximum or minimum, we express the pattern as 

( ma x | mi n) i mu m 

H ere are some more examples: 


Expression 

Description 

[ wb](ad| eed) 

Matches wad, weed, bad, and b e e d. 

( p r o | anti )- 00? 

Matches pro- OOP and a n t i - OOP. 

( AZ|CA| CO) [ 0-9]{4} 

Matches A Z xxxx, C A xxxx, and COxxxx, 
where x is a single digit. 


The replaceAll Method 

Using the replaceAll method, we can replace all occurrences of a substring that 
matches a given regular expression with a given replacement string. For example, 
here's how to replace all vowels in the string with the @ symbol: 

String originalText, modi fi edText; 

ori gi nalText = ...; //assign string to 'originalText 1 
modi fi edText = originalText. replaceAll! "[aeiou] “ , 11 ; 

N otice the original text is unchanged. The replaceAll method returns a modified text 
as a separate string. H ere are more examples: 


Expression 


Description 

str. repl aceAl1("OOP", 
"object-oriented programming") 

Replace all occurrences of OOP with 
object-oriented programming. 

st r. r epl aceAl1( 

" [ 0 - 9 ] {3} - [ 0 - 9 ] { 2 } - [ 0 - 9 ] { 4}", 

Replace all social security numbers 
with xxx-xx-xxxx. 

"xxx-xx-xxxx") 



st r. r epl aceAl1 

" o {2, }", “oo") 

Replace all occurrences of a sequence 
that has two or more of letter 0 with 0 0 . 
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If we want to match only the whole word, we have to use the \b symbol to des¬ 
ignate the word boundary. Suppose we write 

str. repl aceAl I ("temp", “temporary"); 

expecting to replace all occurrences of the abbreviated word temp by temporary. 
We will get a surprising result. All occurrences of the sequence of characters temp 
will be replaced; so, for example, words such as attempt or tempting would be 
replaced by attemporarytortemporaryting, respectively. To designate the sequence 
temp as a whole word, we place the word boundary symbol \b in the front and end 
of the sequence. 

str. repl aceAl I ("\\btemp\\b", "temporary”); 

Notice the use of two backslashes. The symbol we use in the regular expres¬ 
sion is\b. However, we must write this regular expression in a string representation. 
A nd remember that the backslash symbol in a string represents a control character 
such as\n, \t, and \r. To specify the regular expression symbol with a backslash, we 
must use additional backslash, so the system will not interpret it as some kind of 
control character. The regular expression we want here is 

\ bt emp\ b 

To put it in a string representation, we write 

" \ \ b t e mp \ \ b" 

Here are the common backslash symbols used in regular expressions: 


Expression 

String 

Representation 

Description 

\d 

" \ \ d " 

A single digit. Equivalent to [ 0 - 9 ] . 

\ D 

"\\D" 

A single nondigit. Equivalent to [ A 0 - 9 ] . 

\ s 

"Us" 

A white space character, such as space, 
tab, new line, etc. 

\ s 

"US" 

A non-white-space character. 

\ w 

"\\ w" 

A word character. Equivalent to 
[ a - zA-Z_ 0 - 9 ] . 

\ W 

" \ \ W" 

A nonword character. 

\ b 

" \ \ b" 

A word boundary (such as a white space 
and punctuation mark). 

\ B 

" \ \ B" 

A nonword boundary. 


We also use the backslash if we want to search for a command character. For 
example, the plus symbol designates one or more repetitions. If we want to search 
for the plus symbol in the text, we use the backslash as \+ and to express it as a 
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string, we write "\\+". Here's an example. To replace all occurrences of c and C++ 
(not necessarily a whole word) with Java, we write 

s t r. r e p I a c e AI I ( 11 ( C | C \ \ +\ \ +) " , " J a v a 11 ); 


F— 

Quick 

CHECK 


1. Describe the string that the foil owing regular expressions match. 

a. a * b 

b. b [ a i u ] d 

c. [ Oo] bj ect ( s | ) 

2. Write a regular expression for a state vehicle license number whose format is 
a single capital letter, followed by three digits and four lowercase letters. 

3. Which of the following regular expressions are invalid? 

a. (a - z) * + 

b. [ a | a b]xyz 

c. a b e - 14 

d. [ a -z && A a A b] 

e. [ / / one] t wo 


9.4 The Pattern and Matcher Classes 

The matches and replaceAll methods of the string class are shorthand for using the 
Pattern and Matcher classes from the java.util.regex package. We will describe how 
to use these two classes for more efficient pattern matching. 

The statement 

str. matches(regex); 

where str and regex are string objects is equivalent to 

Pattern. matches(regex, str); 

which in turn is equivalent to 

Pattern pattern = Pattern, compi I e( regex) ; 

Matcher matcher = pattern, matcher(str); 
ma t c h e r. ma t c h e s ( ); 

Similarly, the statement 

str. repl a c e AI I (regex, repl acement); 

where replacement is a replacement text is equivalent to 

Pattern pattern = Pattern, compi I e( regex) ; 

Matcher matcher = pattern, matcher(str); 
matcher, repl a c e AI I (repl acement); 
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Explicit creation of Pattern and Matcher objects gives us more options and 
greater efficiency. We specify regular expressions as strings, but for the system to 
actually carry out the pattern-matching operation, the stated regular expression 
must first be converted to an internal format. This is done by the compile method 
Of the Pattern class. When we use the matches method Of the String or Pattern 
class, this conversion into the internal format is carried out every time the 
matches method is executed. So if we use the same pattern multiple times, then it 
is more efficient to convert just once, instead of repeating the same conversion, 
as was the case for the Ch9MatchJavaldentifier and Ch9MatchPhoneNumber 
classes. The following is ch9MatchJavaidentifierPM, a more efficient version of 
Ch9Match Java Identifier: 


/ * 

Chapter 9 Sample Program: Checks whether the input 
string is a valid Identifier. This version 
uses the Matcher and Pattern classes. 

Fi le: Ch9MatchJ aval denti fI erPM.j ava 

*/ 

import java.util.*; 
import java,util.regex.*; 

class Ch9Matchjava I dent i f I erPM { 

private static final String STOP = “STOP": 

private static final String VALID = “Valid java identifier"; 

private static final String INVALID = “Not a valid java identifier"; 

private static final String VALID IDENTIFIER PATTERN 

= " [a-zA-Z][a-zA-Z0-9_$]*" ; 

public static void main (String!) args) { 

Scanner scanner = new Scanner(System. in); 

String st r, reply; 

Ma t c he r ma t c he r; 

Pattern pattern 

= Pattern, compi I e ( VALI D_l DENTI FI ER_PATTERN) ; 


whiIe (true) { 

System, out. print) “Identifier: " 
str = Scanner. next(); 

if ( st r . equal s (STOP) ) break; 

matcher = pattern, matcher(str); 

if ( ma t c h e r. ma t c h e s ( )) { 
reply = VALI D; 
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} else { 

reply = I NVALI D; 

} 


} 


System, out. pri ntl n(str + ": " + reply + " \ n" ) ; 


We have a number of opti ons when the Pattern compi I es i nto an i nternal format. 
For example, by default, the period symbol does not match the line terminator char¬ 
acter. We can override this default by passing dotall as the second argument as 

Pattern pattern = Pattern, compi I e( regex, Pattern. DOTALL); 

To enable case-insensitive matching, we pass the casejnsensitive constant. 

The find method is another powerful method of the Matcher class. This 
method searches for the next sequence in a string that matches the pattern. The 
method returns true if the patten is found. We can call the method repeatedly until 
it returns false to find all matches. Here's an example that counts the number of 
times the word java occurs in a given document. We will search for the word in a 
case-insensitive manner. 


/ * 

Chapter 9 Sample Program: 

Count the number of times the word 'java * 1 occurs 
in input sentence using pattern matching. 

File: Ch9CountJ avaPM. j ava 

*/ 

import java.util.*; 
import java,util.regex.*; 

class Ch9CountJ avaPM { 

public static void main (String!) args) { 

Scanner scanner = new Scanner(System. in); 

scanner. useDeli mi ter(System. getProperty("l i ne, separator") ); 

String document; 

i nt j avaCount; 

Mat c h er ma t c he r; 

Pattern pattern = Pattern.compile!" java", 

Pattern.CASEJ NSENSITlVE); 
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} 


System, out. pri n11 n(" Sentence: "); 
document = scanner. next(); 

j avaCount =0; 

matcher = pattern, matcher(document); 
while (matcher.fi nd()) { 
j avaCount ++; 

} 

System, out. pri n 11 n ( “The word 'java' occurred " + 
j a v a C o u n t + " t i me s. ") ; 


When a matcher finds a matching sequence of characters, we can query the 
location of the sequence by using the start and end methods. The start method 
returns the position in the string where the first character of the pattern is found, and 
the end method returns the value 1 more than the position in the string where the 
last character of the pattern is found. Here's the code that prints out the matching 
sequences and their locations in the string when searching for the word java in a 
case-insensitive manner. 



Chapter 9 Sample Program: 


Displays the positions of the word 'java 1 

in a given string using pattern -matching technique. 

File: Ch9LocateJ avaPM. java 

*/ 

import javax.swing,*; 
import java,util.regex.*; 

class Ch9Locatej avaPM { 

public static void main (String!) args) { 

Scanner scanner = new Scanner(System. in); 

scanner. useDel i mi ter(System, getProperty("l i ne. separator")); 

String document; 

Mat c her mat c her; 

Pattern pattern = Pattern. compile!" java", 

Pattern.CASEJ NSENSITl VE); 
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System, out. pri ntl n( "Sentence: "); 
document = scanner. next(); 

matcher = pattern, matcher(document); 

while ( mat c her.fi nd( )) { 

System, out. pri ntl n( document . subst ri ng(matcher. start)), 

matcher.end))) 
+ " found at position " 

+ ma t c h e r. s t a r t () ); 

} 

} 

} 


P— “ 

Quick 

CHECK 


1. Replace the following statements with the equivalent ones using the Pattern 
and Matcher classes. 

a. str. repl aceAl I ("1", "one"); 

b. s t r. ma t c h e s ( " a I p h a" ) ; 

2. Using the find method of the Matcher class, check if the given string 
document contains the whole word Java. 


9.5 


Comparing Strings 


We already discussed how objects are compared in Chapter 5. The same rule applies 
for the string, but we have to be careful in certain situations because of the differ¬ 
ence in the way a new string object is created. First, wewill review how theobjects 
are compared. The difference between 


String wo r d1, wo r d 2; 


= = versus if ( wo r d 1 == wo r d 2 ) 

equals 

and 

if ( wordl. equal s(word2) ) ... 

is illustrated in Figure 9.2. The equality test == is true if the contents of variables are 
the same. Fora primitive data type, the contents are values themselves; but for a ref¬ 
erence data type, the contents are addresses. So for a reference data type, the equality 
test is true if both variables refer to the same object, because they both contain the 
same address. The equals method, on the other hand, is true if the string objects to 
equivalence which the two variables refer contain the same string value. To distinguish the two 
types of comparisons, we will use the term equivalence test for the equals method. 
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Case A: Referring to the same object, 
wordl word2 



wordl == word2 is true 

wordl.equals( word2 ) is true 

/ " ; \ 

Note: If X == y is true, then x.equals(y) i S 

also true. The reverse is not always true. 


Case B: Referring to different objects having identical string values, 
wordl word2 



wordl == word2 
wordl.equals( word2 ) 


is f al se 
is true 


Case C: Referring to different objects having different string values, 
wordl word2 

wordl == word2 is fal se 

wordl. equals { word2 ) is false 


Figure 9.2 The difference between the equality test and the equals method. 

As long as we create a new string object as 

String str = new String) "Java"); 

using the new operator, the rule for comparing objects applies to comparing strings. 
However, when the new operator is not used, for example, in 

String str = "Java"; 

we have to be careful. Figure 9.3 shows the difference in assigning a string object 
to a variable. If we do not use the new operator, then string data are treated as if they 
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String wordl, word2; 


wordl 


word2 



String wordl, word2; 
wordl = "Java"; 


word2 = "Java"; 


Literal string constant such asjava "will 
^ always refer to the one object. 


wordl word2 



Figure 9.3 Difference between using and not using the new operator for String. 


are primitive data type. When we use the same literal string constants in a program, 
there will be exactly one string object. 


Quick 

CHECK 


1. Show the state of memory after the following statements are executed. 

String st r 1, st r 2, st r 3; 
s t r 1 = " J a s mi n e" ; 
s t r 2 = "Oolong"; 
s t r 3 = s t r 2; 
st r 2 = st r 1; 


9.6 StringBuffer and StringBuilder 

A string object is immutable, which means that once a string object is created, we 
cannot change it. In other words, we can read individual characters in a string, but 
we cannot add, delete, or modify characters of a string object. Remember that the 
methods of the string class, such as replaceAll and substring, do not modify the 
original string; they return a new string. Java adopts this immutability restriction 
to implement an efficient memory allocation scheme for managing string objects. 
The immutability is the reason why we can treat the string data much as a primitive 
data type. 
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Creating a new string from the old one will work for most cases, but some 
times manipulating the content of a string directly is more convenient. When we 
need to compose a long string from a number of words, for example, being able to 
manipulate the content of a string directly is much more convenient than creating a 
string new copy of a string. String manipulation here means operations such as replacing 

manipulation a character, appending a string with another string, deleting a portion of a string, and 
so forth. If we need to manipulate the content of a string directly, we must use either 
the stringBuffer or the stringBuilder class. Here's a simple example of modifying 
the string Java to Diva using a StringBuffer object: 

StringBuffer word = new StringBuffer) "java” ); 
word. setCharAtfO, 1 D 1 ); 
word. setCharAtf 1, 1 i 1 ); 

Notice that no new string is created, the original string Java is modified. Also, we 
must use the new method to create a stringBuffer object. 

The stringBuffer and stringBuilder classes behave exactly the same (i.e„ they 
support the same set of public methods), but the stringBuilder class in general has a 
better performance. The stringBuilder class is new to Java 2 SDK version 1.5, so it 
cannot be used with the older versions of Java SDK. There are advanced cases 
where you have to use the StringBuffer class, but for the sample string processing 
programs in this book, we can use either one of them. Of course, to use the string¬ 
Builder class, we must be using version 1.5 SDK. We can also continue to use the 
stringBuffer class with version 1.5. 

Because the StringBuffer class can be used with all versions of Java SDK, and 
the string processing performance in not our major concern here, we will be using 
the StringBuffer class exclusively in this book. If the string processing performance 
is a concern, then all we have to do is to replace all occurrences of the word String- 
Buffer to StringBuilder in the program and run it with version 1.5 SDK. 
stringBuffer Let's look at some examples using StringBuffer objects. The first example 

reads a sentence and replaces all vowels in the sentence with the character x. 



Chapter 


Sample Program: Replace every vowel in a given sentence 
with 'X 1 using StringBuffer. 


File: Ch9Repl aceVowel sWi thX.j ava 

*1 


import java.util.*; 

class Ch9Rep I aceVowel sWithX { 

public static void main (String!) args) { 

Scanner scanner = new Scanner(System. in); 

scanner. useDel i miter(System. getPropertyl “I i ne, separator 11 )); 
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Stri ngBuffer tempStringBuffer; 

String inSentence; 

i nt n u mb e r Of Ch a r a c t e r s; 

char letter; 

System, out. printing Sentence: "); 
inSentence = scanner, next)); 

tempStri ngBuffer = new Stri ngBufferfi nSentence); 
number Of Characters = tempStri ngBuffer. length)); 
for ( i nt index = 0; index < numberOfCharacters; i n d e x + + ) { 
letter = tempStringBuffer. charAt(index); 


et t e r 

== ' a' 

|| letter == 1 A 1 

! 1 

et t e r 

== 1 e 1 

letter == 1 E 1 

11 

et t e r 

== ' i ' 

letter == 1 I 1 

11 

et t e r 

== 1 o' 

letter == 1 O' 

I! 

et t e r 

== 1 u 1 

letter == 1 U 1 



tempStri ngBuffer. s e t C h a r A t ( i ndex, ' X' ); 

} 

} 

System, out. printlnf" Input: " + inSentence); 
System, out. printlnf" Output: " + temp StringBuffer); 

} 

} 


Notice how the input routine is done. We are reading in a string object and 
converting it to a StringBuffer object, because we cannot simply assign a string 
object to a StringBuffer variable. For example, the following code is invalid: 

StringBuffer strBuffer = scanner. next ( ) ; 

We are required to create a StringBuffer object from a string object as in 

String s t r = "Hello"; 

StringBuffer strBuf = new StringBuffer) str ); 



hings to Remember 


l/l/e cannot input StringBuffer objects. We have to input String objects and 
convert them to StringBuffer objects. 
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Our next example constructs a new sentence from input words that have an 
even number of letters. The program stops when the word stop is read. Let's begin 
with the pseudocode: 

set tempStringBuffer to empt y string; 

repeat = true; 
while ( repeat ) { 
read in next word; 

if ( word is "STOP"} { 
repeat = false; 

} else if ( word has even number of letters) { 
append word to tempStr i ngBuffer ; 

} 

} 

A nd here's the actual code: 


Chapter 9 Sample Program: Constructs a new sentence from 

input words that have an even number of letters. 

File: Ch9EvenLetterWords.java 

*1 

import j avax. swi ng. *; 
class Ch9EvenLetterWords { 

public static void main (String!] args) { 

Scanner scanner = new Scanner(System. in); 

boolean repeat = true; Create StringBuffer object 

String word; with an empty string. 

StringBuffer tempStringBuffer = new StringBuffer!""); 

while (repeat) { 

System, out. pri nt("Next word: "); 
word = scanner, next ( ); 

if ( wo r d,equaI s ( "STOP" )) { 

repeat = false; 

} else if (word,length!) % 2 = = 0 ) { 

Append word 

t empSt r i ngBuf f er. append! wor d + " "); and a space to 

} tempStringBuffer. 

} 
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} 


System, out. print Inf " Output: " + temp StringBuffer); 


We use the append method to append a String or a StringBuffer object to the 
end of a StringBuffer object. The method append also can take an argument of the 
primitive data type. For example, all the following statements are valid: 

i nt i =12; 

fI oat x = 12. 4f; 

char c h = 1 W 1 ; 

StringBuffer str = new StringBuffer!""); 

st r. append! i ); 
str. append(x); 
str. append! c h) ; 

Any primitive data type argument is converted to a string before it is appended to a 
StringBuffer object. 

Notice that we can write the second example using only string objects. Here's 

how: 


boolean repeat = true; 

String word, newSent ence; 

newSentence = //empty string 

whiIe (repeat) { 

System, out. print! "Next word: 
word = scanner, next ( ) ; 


if (word, equal s("ST0P")) { 
repeat = f alse; 


} 


} else if ( word.I engt h( ) % 2 == 0) { 
newSentence = newSentence + word; 

//st ri ng 


} 


concatenati on 


Although this code does not explicitly use any StringBuffer object, the Java 
compiler may use StringBuffer when compiling the string concatenation operator. 
For example, the expression 


newSentence + word 


can be compiled as if the expression were 

new Stri ngBuffer!) . append(word). toStri ng () 
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Using the append method of stringBuffer is preferable to using the string concate¬ 
nation operator + because we can avoid creating temporary string objects by using 

StringBuffer. 

In addition to appending a string at the end of stringBuffer, we can insert a string 
at a specified position by using the insert method. The syntax for this method is 

<Stri ngBuffer> . insert ( <i nsertl ndex>, <v a I u e > ) ; 

where <insertindex> must be greater than or equal to 0 and less than or equal to the 
length of <stringBuffer> and the <value> is an object or a value of the pri miti ve data 
type. For example, to change the string 

j ava is great 


to 

java is really great 

we can execute 

StringBuffer str = new StringBuffer!“ Java is great"); 
s t r.i n s e r t ( 8, "really " ) ; 


r— 

Quick 

CHECK 


1. Determine the value of str after the following statements are executed. 


a. 

St ri ngBuffer 

str 




= new 

Stri ngBuffer! 

"Caffeine" ) ; 


str.i nsert ( 0, 

"Dr. " ; 

1; 


b. 

St ri ng 

str = 1 

' Ca f f ei 

ne"; 


St r i ngBuffer 

strl = 




new StringBuffer! 

st r. s u bs t r i ng( 1, 3 ) 


strl. append!' 

e 1 ) ; 




str = " De" + 

strl; 



c. 

St ri ng 

str = 1 

' C a f f e i 

ne" ; 


Stri ngBuffer 

str = 




new StringBuffer! str. substri ng ( 4, 8); 
s t r 1. insert ( 3, ' f' ) ; 
str = " De" + st r 1 


2. Assume a String object str is assigned as a string value. Write a code segment 
to replace all occurrences of lowercase vowels in a given string to the letter c 
by using String and StringBuffer objects. 

3. Find the errors in the following code. 

String str = "Caffeine"; 

StringBuffer strl = str. substri ng ( 1, 3); 
st r 1. append!' e 1 ) ; 

System, o u t ( s t r 1 ) ; 
strl = strl + str; 
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9.7 String Processing and Bioinformatics 

Bioinformatics is a field of study that explores the use of computational techniques 
in solving biological problems. One of the well-known bioinformatics project is the 
Human Genome Project sponsored by the U.S. Department of Energy and the 
National Institutes of Health. The project was started in 1990 and concluded suc¬ 
cessfully in 2003, two years ahead of the schedule. One of the very challenging 
goals of the project was to identify all the genes in human body. The project has 
estimated that a human body contains 20,000-25,000 genes. 

Genes are made of DNA (deoxyribonucleic acid), which is a sequence of mol¬ 
ecules called nucleotides or bases. DNA contains genetic information used by the 
cell to produce proteins. Our bones, muscles, blood, and organs are all made of pro¬ 
teins. Our well-being, therefore, is determined by the cells functioning properly 
when creating proteins. DNA provides instructions to the cell, so it serves a role 
similar to a computer program. A cell is a computer that produces proteins (output) 
by reading instructions in DNA (program). 

The genetic information in DNA is encoded as a sequence of four chemical 
bases—adenine (A), guanine (G), cytosine (C), and thymine (T). In contrast a 
computer program is a sequence of binary numbers 0 and I. These four chemical 
bases are formed into base pairs by pairing A with T and G with C. Base pairs 
are arranged in two long strands (called sugar phosphate backbone ) that form a 
spiral famously known as a double helix. Every cell (be it a nerve cel I, skin cell, or 
muscle cell) contains the same DNA, and when a cell divides, the exact copy of 
DNA in the old cell is replicated in the new cell. What is amazing, ignoring the 
moral issues, is that, in theory, we can create a clone of a person from a single cell 
because the cel I contains the DNA that encodes the complete genetic information of 
the person. 

So what does computer programming, specifically string processing, have to 
do with DNA? DNA is encoded as a sequence of bases. This information can be 
represented as a string of four letters—A, T, G, and C, and common operations 
biologists perform on DNA sequences can be implemented as string processing 
programs. Let's look at some examples. 

The first example is finding the GC-content of a given DNA sequence. The 
GC-content is simply the percentage of guanine (G) and cytosine (C) in the DNA 
sequence. If we let the expressions Ca, Cg, Cc, and Cj stand for the count of ade¬ 
nine, guanine, cytosine, and thymine, respectively, in the DNA sequence, then the 
GC-content is computed as follows: 


Cg + C c 

Ca + Cj + Cg + Cc 


X 100 


Because any DNA sequence can contain only four types of bases, the length of 
string that represents a DNA sequence is equal to Ca + Cj + Cg + Cc. In other 
words, we only need to count the number of Gs and Cs. It’s not necessary to count 
the number of As and Ts. 
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Here's the complete program. In the actual use, we would expect the DNA 
sequence (String) will be read from a file, as it will be quite long. Since we have not 
yet covered the file I/O, we will use a Scanner to input a DNA sequence. 


Chapter 9 Sample Program: Determine the GC-content of a given DNA sequence. 
File: Ch9GCCont e nt.j a va 

*1 

import java.util.*; 
class Ch9GCCont ent { 

public static void main (String!) args) { 

Scanner scanner = new Scanner(System. in); 

String d n a; 

i nt g c Co u n t; 
i nt size; 
char base; 
double result; 

whiIe (true) { 

System, out. print) "Next DNA Sequence: "); 
dna = scanner. next(); 

if (dna. equal si gnoreCase("STOP") ) { 
break; 

} 

size = dna. length)); 
gcCount =0; 

for ( i nt i =0; i < si z e; i ++) { 

base = dna.char At (i); 

if (base == 1 G 1 | | base == 1 C 1 ) { 
gcCount ++; 

} 

} 

result = gcCount * 100 / size; 

System, out. pri ntl n("GC-Content: " + result + " %" ); 

System, out. pri ntl n ( "" ) ; 

} 

} 

} 
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In the next example, we will implement the transcription operation. DNA tran¬ 
scription is a process of synthesizing an RNA (ribonucleic acid), which is an 
intermediate step when creating proteins. Similar to DNA, RNA is composed 
of nucleotides. But unlike DNA, RNA is usually single-stranded and, instead 
of thymine, contains uracil (U). So, we transcribe a given DNA to an RNA by 
creating a new string that replaces Ts in the given DNA with Us. Here's the 
program: 


/ * 

Chapter 9 Sample Program: Transcribe DNA into RNA. 

File: Ch9Transcri be DNA, java 

*1 

import java.util.*; 

class Ch9Transcri be DNA { 

public static void main (String!) args) { 

Scanner scanner = new Scanner(System. in); 

String d n a; 

Stri ngBuffer rna; 

int size; 
char base; 

wh iIe (true) { 

System, out. pri nt("Next DNA Sequence: "); 
dna = scanner. next(); 

if (dna. equal si gnoreCase("STOP") ) { 
break; 

} 

size = dna. length)); 
rna = new Stri ngBuffer(); 

II scan through each letter and replace T with U 
for ( i nt i = 0; i < s i z e; i ++) { 

base = dna.charAt(i); 

if (base == 1 T 1 ) { 
base = 1 U 1 ; 

} 

rna. append) base) ; 

} 
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System, out. pri ntl n("RNA: " + rna.toString(l); 
System, out. pri ntl n ( "" ) ; 

} 

} 

} 


We can use the pattern-matching approach here instead of the basic string 
processing approach shown in the program. The implementation of the pattern¬ 
matching approach is left as an exercise. 

Let's try one more example. This time we output the reverse of a given 
DNA sequence. The program is actually very straightforward if we realize that the 
stringBuffer class includes the reverse method. (Note: You can, of course, imple¬ 
ment the operation without using the reverse method.) Here's the program that uses 
the reverse method Of the StringBuffer class: 


Chapter 9 Sample Program: Output the reverse sequence of a given DNA. 
File: Ch9ReverseDNA.java 

*/ 

import java,util.*; 

class Ch9Rever seDNA { 

public static void main (String!) args) { 

Scanner scanner = new Scanner ( System, in); 

String d n a; 

StringBuffer result; 

whiIe (true) { 

System, out. print) "Next DNA Sequence: "); 
dna = scanner. next(); 

if (dna. equal si gnoreCase("STOP") ) { 
break; 

} 

result = new Str i ngBuffer ( dna ) ; 
resul t. reverse)); 

System, out. pri ntl n("RNA: " + result.toStri ng()); 

System, out. pri ntl n ( "" ) ; 

} 

} 

} 
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9.8 Sample Development 


Building Word Concordance 

One technique to analyze a historical documentor literature is to track word occurrences, 
word con- A basic form of word concordance is a list of all words in a document and the number of 
cordance times each word appears in the document. Word concordance is useful in revealing the 
writing style of an author. For example, given a word concordance of a document, we can 
scan the list and count the numbers of nouns, verbs, prepositions, and so forth. If the 
ratios of these grammatical elements differ significantly between the two documents, 
there is a high probability that they are not written by the same person. Another appli¬ 
cation of word concordance is seen in the indexing of a document, which, for each 
word, lists the page numbers or line numbers where it appears in the document. In this 
sample development, we will build a word concordance of a given document, utilizing 
the string-processing technique we learned in this chapter. 


C[lou 

s) Might 
Want to 

Know 


One of the most popular search engine websites on the Internet today is Google 
(www.google.com). At the core of their innovative technology is a concordance of 
all Web pages on the Internet. Every month the company's Web crawler software 
visits 3 billion (and steadily growing) Web pages, and from these visits, a concor¬ 
dance is built. When the user enters a query,the Google servers search the concor¬ 
dance for a list of matching Web pages and return the list in the order of relevance. 


Problem Statement 

Write an application that will build a word concordance of a document. The 
output from the application is an alphabetical list of all words in the given 
document and the number of times they occur in the document. The docu¬ 
ments are a text file (contents of the file are ASCII characters), and the output 
of the program is saved as an ASCII file also. 

Overall Plan 

As usual, let's begin the program development by first identifying the major tasks of the 
program. The first task is to get a text document from a designated file. We will use a 
helper class called FileManager to do this task. File processing techniques to implement 
the FileManager class will be presented in Chapter 12. The whole content of an ASCII file 
is represented in the program as a single String object. Using a pattern-matching tech¬ 
nique, we extract individual words from the document. For each distinct word in the doc¬ 
ument, we associate a counter and increment it every time the word is repeated. We 
will use the second helper class called WordList for maintaining a word list. An entry 
in this list has two components—a word and how many times this word occurs in the 
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document.A WordList object can handle an unbounded number of entries. Entries in the 
list are arranged in alphabetical order.We will learn how to implement the WordList class 
in Chapter 10. 

We can express the program logic in pseudocode as 


while ( the user wants to process another file ) { 
Task 1: read the file; 


program 

tasks 


Task 2: build the word list; 


Task 3: save the word list to a file; 


Let's look at the three tasks and determine objects that will be responsible for 
handling the tasks. For the first task, we will use the helper class FileManager. For the 
second task of building a word list, we will define the Ch9WordConcordance class, whose 
instance will use the Pattern and Matcher classes for word extraction, and another 
helper class WordList for maintaining the word list. The last task of saving the result is 
done by the FileManager class also. 

Finally, we will define a top-level control object that manages all other objects. We 
will call this class Ch9WordConcordanceMain. This will be our instantiable main class. 
Flere's our working design document: 


program 

classes 


Design Document: Ch 9 Wo rdConcordanceMai n 


Class 

C h 9 Wo r dConcordanceMai n 


Purpose 

The instantiable main class of the program 
that implements the top-level program 
control. 

The key class of the program. An instance of 
this class manages other objects to build the 
word list. 

A helper class for opening a file and saving 
the result to a file. Details of this class can be 
found in Chapter 12. 

Another helper class for maintaining a word 
list. Details of this class can be found in 
Chapter 10. 

Classes for pattern-matching operations. 


C h 9 Wo rdConcordance 


F i I e Ma na ge r 


Wo r d L i st 


Pattern/ Matcher 


Figure 9.4 is the working program diagram. 
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a 


A helper class 
provided to us 


0 


A class we 
implement 



System 

classes 

5 




Figure 9.4 The program diagram for the Ch9WordConcordanceMain program. Base system classes 
such as String and JOptionPane are not shown. 


■LajlTtWW In lieu of the Pattern and Matcher classes, we could use the String-Tokenizer 

class. This class is fairly straightforward to use if the white space (tab, return, blank, 
etc.) is a word delimiter. However, using this class becomes a little more compli¬ 
cated if we need to include punctuation marks and others as a word delimiter also. 
Overall, the Pattern and Matcher classes are more powerful and useful in many 
I types of applications than the String-Tokenizer class. 


development 

steps 


We will implement this program in four major steps: 

1. Start with a program skeleton. Define the main class with data members. To test 
the main class, we will also define a skeleton Ch9WordConcordance class with 
just a default constructor. 

2. Add code to open a file and save the result. Extend the step 1 classes as necessary. 

3. Complete the implementation of the Ch9WordConcordance class. 

4. Finalize the code by removing temporary statements and tying up loose ends. 
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9.8 Sample Development— continued 


Step 1 Development: Skeleton 

step 1 The design of Ch9WordConcordanceMain is straightforward,as its structure is very sim- 

design ilar to that of other main classes. We will make this an instantiable main class and define 

the start method that implements the top-level control logic. We will define a default 
constructor to create instances of other classes. A skeleton Ch9WordConcordance class 
is also defined in this step so we can compile and run the main class. The skeleton 
Ch9WordConcordance class only has an empty default constructor.The working design 
document for the Ch9WordConcordanceMain class is as follows: 


Design Document: The Ch 9 Wo rdConcordanceMai n Class 

Method 

Visibility 

Purpose 

<const ruct or > 

p u b 1 i c 

Creates the instances of other classes in the 



program. 

start 

private 

Implements the top-level control logic of 
the program. 


step 1 code 


For the skeleton, the start method loops (doing nothing inside the loop in this 
step) until the user selects No on the confirmation dialog. Here's the skeleton: 


Ch 

a pt e r 

9 

Sa mp 

1 e 

Devel( 

a p me n t 

Fi 

1 e: St 

ep 

1/ Ch 

9 Wo 

r dCom 

:or dan 

*1 







i mp o r t 

java. 

ut 

i 1 . * 

; 



class 

C h 9 Wo r 

dC 

onco 

r d a 

n c e Ma i 

n { 

pr 

i vat e 

St 

at i c 

e n 

u m Re: 

;ponse 

P r 

i vat e 

Fi 

1 e Ma 

nag 

er f i 1 

e Ma n a 

pr 

i vat e 

Ch 

9 Wo r 

dCo 

ncord; 

a n c e b 

pr 

i vat e 

Sc 

a n ne 

r s 

c a n nei 



: Word Concordance 
c e Ma i n. j a v a 


{YES, NO} 

ger; 
j I I d e r; 


II Ma i n met hod 


public static void main(String[] args) { 

C h 9 Wo rdConcordanceMai n main = new Ch9WordConcordanceMain(); 
mai n. s t a r t () ; 

} 
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public Ch9WordConcordanceMai n() { 

fiI eManager = new FileManager( ); 

builder = new Ch9WordConcordance( ); 

scanner = new ScannerfSystem. in); 

} 

private void start! ) { 

Response user Re ply; 
whiIe (true) { 

userReply = p r o mp t ( "Run the program?" ); 

if (userReply == Res pons e. NO) { 

break; 

} 

} 

System, out. print Inf 11 Thank you for using the program, Good-Bye"); 

} 

private Response prompt(String question) { 

String input; 

Response response = Response,NO; 

System, out. pri ntfquesti on + 11 (Yes - y; No - n): "); 
input = scanner, n ex t ( ) ; 

if ( i n p u t. e q u a I s ( 11 Y" ) | | i n p u t. e q u a I s (" y" )) { 
response = Response, YES; 

} 

return response; 

} 

} 


The skeleton Ch9WordConcordance class has only an empty default constructor. 
Here's the skeleton class: 



class Ch9WordConcor dance { 


public Ch9WordConcordance() { 

} 


} 
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9.8 Sample Development— continued 


step 1 test We run t ^ e program and verify that the constructor is executed correctly, and the 

repetition control in the start method works as expected. 

Step 2 Development: Open and Save Files 

step 2 In the second development step, we add routines to handle input and output. The tasks of 

design opening and saving a file are delegated to the service class FileManager.We will learn the 

implementation details of the FileManager class in Chapter 1 2. Our responsibility right 
now is to use the class correctly. The class provides two key methods:one to open a file and 
another to save a file. So that we can create and view the content easily, the FileManager 
class deals only with text files.To open a text file, we call its openFile method.There are 
two versions. With the first version, we pass the filename. For example, the code 

FileManager fm = new FileManager!); 

String doc = ...; //assign string data 

fm. saveFi I e("outputl. txt", doc); 

will save the string data doc to a file named outputl .txt. With the second version, we will 
let the end user select a file, using the standard file dialog. A sample file dialog is shown in 
Figure 9.5. With the second version, we pass only the string data to be saved as 

fm. saveFi I e(doc); 

When there's an error in saving a file, an lOException is thrown. 

To open a text file, we use one of the two versions of the openFile method. The 
distinction is identical to the one for the saveFile methods.The first version requires the 



Figure 9.5 A sample file dialog for opening a file. 
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filename to open. The second version allows the end user to select a file to save the data, 
so we pass no parameter. The openFile method will throw a FileNotFoundException 
when the designated file cannot be found and an lOException when the designated 
file cannot be opened correctly. 

Here's the summary of the FileManager class: 


Public Methods of F i I eManager 

public String openFi I e(Stri ng filename) 

throws FileNotFoundException, lOException 
Opens the text file f i I e n a me and returns the content as a S t r i n g . 
public String openFi I e ( ) 

throws FileNotFoundException, lOException 
Opens the text file selected by the end user, using the standard file open dialog, 
and returns the content as a S t r i n g . 
public String saveFiI e(Stri ng filename, String data) 
t hr ows I OExcepti on 
Save the string data to f i I e n a me. 

public String saveFiI e(Stri ng data) throws lOException 

Saves the string data to a file selected by the end user, using the standard file 
save dialog. 


We modify the start method to open a file, create a word concordance, and then 
save the generated word concordance to a file. The method is defined as follows: 

private void start) ) { 

Response user Re ply; 

String document, wordList; 

whiIe (true) { 

userRepI y = prompt! "Run the program?"); 

if ( us er Re pi y == Res po ns e. NO) { 

break; 

} 


Added portion 


document = i nputFiI e(); II open file 

wordList = build(document); //build concordance 

saveFiI e( wordLi st ); //save the generated concordance 

} 

... //'Good-bye 1 message dialog 
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9.8 Sample Development— continued 


The inputFile method is defined as follows: 


private String inputFile) ) { 

String doc = " " ; 

try { 

doc = fiI eManager. openFiI e( ); 


} catch ( F iIeNot F oundException e) { 

System, out. p r i n 11 n ( " File not found."); 


} catch ( lOException e) { 

System, out. p r i n 11 n ( " Error in opening file 
+ e,get Message))); 


} 


System, out. println)" Input Document: \ n" + doc); //TEMP 

return doc; 


with a temporary output to verify the input routine. Because the openFile method of 
FileManager throws exceptions, we handle them here with the try-catch block. 

The saveFile method is defined as follows: 


private void saveFiI e( Stri ng list) { 

try { 

fi I eManager. saveFiI e(l i st); 


} 


} catch (lOException e) { 

System, out. println) “Error in saving file 

+ e.get Message))); 


} 


The method is very simple as the hard work of actually saving the text data is done by our 
FileManager helper object. 

Finally, the build method is defined as 

private String buiI d(Stri ng document) { 

String concordance; 

concordance = bui I der. bui I d(document); 
return concordance; 

} 
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The Ch9WordConcordanceMain class is now complete.To run and test this class, 
we will define a stub build method for the Ch9WordConcordance class.The method is 
temporarily defined as 

public String buiI d(Stri ng document) { 

//TEMP 
String list 

= “one 14\n t wo 3\nthree 3\n f o u r 5\n fiv e 9 2 \ n" ; 
return list; 

//TEMP 

} 

We will implement the method fully in the next step, 
step 2 code Here's the final Ch9WordConcordanceMain class: 


/* 

Chapter 9 Sample Development: Word Concordance 
Fi I e: St ep2 / Ch9WordConcor danceMai n.j ava 

*/ 

import j a v a. i o. *; 
import java.util.*; 

class Ch9WordConcordanceMain { 


private String buiI d(Stri ng document) { 

String concordance; 

concordance = builder, bui I d ( d o c ume nt); 
return concordance; 

} 

private String inputFilef ) { 

String doc = ""; 

try { 

doc = fi I eManager. openFiI e( ); 

} catch ( FiIeNotFoundExcepti on e) { 

System, out. printing File not found,"); 

} catch (lOException e) { 

System, out. p r i n 11 n ( " Error in opening file 

} 


build 


( ; n 

inputFile 


+ e. get Message) )); 
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9.8 Sample Development— continued 


System, out, print Inf" Input Document: \ n" + doc); 

return doc; 

} 

private void saveFiI e(Stri ng list) { 

try { 

fi I eManager.saveFi le(li st); 


II TEMP 


saveFile 


He 


} catch (I OExcepti on e) { 

System, out, p r i n 11 n ( " Error in saving file 

} 


private void s t a r t ( ) { 
while (true) { 


+ e, get Message) )) ; 


( - 


start 

J 



document = inputFilef); 
wordList = bui I d(document); 
saveFiI e(wordLi st) ; 


} 


} 


The temporary Ch9WordConcordance class now has the stub build method: 


class ChSWor dConcordance { 

public String buiI d(Stri ng document) { 

//TEMP 

String list = "one 14\n t wo 3\nthree 3\n f o u r 5 \ n fiv e 9 2\n " ; 

return list; 

/ / TEMP 

} 

} 
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step 2 test 


Hints, 


Pitfalls 



step 3 
design 


We are ready to run the program. The step 2 directory contains several sample 
input files. We will open them and verify the file contents are read correctly by checking 
the temporary echo print output to System.out.To verify the output routine, we save to 
the output (the temporary output created by the build method of Ch9WordConcordance) 
and verify its content. Since the output is a text file, we can use any word processor or text 
editor to view its contents. (Note: If we use NotePad on the Windows platform to view the 
file, it may not appear correctly. See the box below on how to avoid this problem.) 


The control characters used for a line separator are not the same for each platform 
(Windows, Mac, Unix, etc.). One platform may use \n for a line separator while an¬ 
other platform may use \r\n for a line separator. Even on the same platform, dif¬ 
ferent software may not interpret the control characters in the same way.To make 
our Java code work correctly across all platforms, we do, for example, 

String newline 

= System. getProperti es(). getProperty("Ii ne. separator"); 
String out put = "line 1" + newline + "line 2" + newline; 

instead of 

String output = "line 1 \nIi n e 2 \ n"; 


Step 3 Development: Generate Word Concordance 

In the third development step, we finish the program by implementing the Ch9Word- 
Concordance class, specifically, its build method. Since we are using another helper class 
in this step, first we must find out how to use this helper class.The WordList class sup¬ 
ports the maintenance of a word list. Every time we extract a new word from the docu¬ 
ment, we enter this word into a word list. If the word is already in the list, its count is 
incremented by 1. If the word occurs for the first time in the document, then the word 
is added to the list with its count initialized to 1. When we are done processing the docu¬ 
ment, we can get the word concordance from a WordList by calling its getConcordance 
method.The method returns the list as a single String with each line containing a word 
and its count in the following format: 

2 Chapter 

1 Early 

1 However 

2 I n 

1 already 

1 also 

1 an 
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9.8 Sample Development— continued 


7 and 

1 are 

2 as 

1 because 

Because a single WordList object handles multiple documents, there's a method 
called reset to clear the word list before processing the next document. Here's the 
method summary: 


Public Methods of Wo r d L i s t 

public void add ( St ri ng word) 

Increments the count for the given word. If the word is already in the list, its count 
is incremented by 1 .If the word does not exist in the list,then it is added to the list 
with its count set to 1. 
public String getConcordance ( ) 

Returns the word concordance in alphabetical order of words as a single string. 
Each line consists of a word and its count, 
public void reset) ) 

Clears the internal data structure so a new word list can be constructed. This 
method must be called every time before a new document is processed. 


The general idea behind the build method of the Ch9WordConcordance class is 
straightforward. We need to keep extracting a word from the document, and for every 
word found, we add it to the word list. Expressed in pseudocode, we have 

while ( document has more words ) { 

word = next word in the document; 

wordLi st. add(word); 

} 

String concordance = wordLi st.getConcordance (); 

The most difficult part here is how to extract words from a document. We can write 
our own homemade routine to extract words, based on the technique presented in 
Section 9.2. However, this is too much work to get the task done. Writing a code that 
detects various kinds of word terminators (in addition to space, punctuation mark, control 
characters such as tab, new line, etc., all satisfy as the word terminator) is not that easy. 
Conceptually, it is not that hard, but it can be quite tedious to iron out all the details. 
Instead, we can use the pattern-matching technique provided by the Pattern and 
Matcher classes for a reliable and efficient solution. 

The pattern for finding a word can be stated in a regular expression as 

\ w+ 
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Putting it in a string format results in 

" \ \ w+“ 


The Pattern and Matcher objects are thus created as 

Pattern pattern = Pattern, compi I e("\\w+"); 

Matcher matcher = pattern, matcher(document); 

and the control loop to find and extract words is 
wordList.resetf); 
wh i I e (matcher.fi nd( )) { 

wordLi st. add( document . substri ng(matcher. start!) , 

matcher.end!))); 

} 

step 3 code Here's the final Ch9WordConcordance class: 


Chapter 9 Sample Development: Word Concordance 
Fi I e: St ep3 / Ch9WordConcor dance, j ava 

*/ 

import java,util.regex.*; 

class Ch9WordConcor dance { 

private static final String WORD = "\\w+"; 
private WordList wordLi s t; 
private Pattern pattern; 

public Ch9WordConcordance() { 
wordLi st = new WordList!); 

pattern = Pattern, compi I e( WO R D ) ; //pattern is compi 

} 

public String bui I d(Stri ng document) { 

Matcher matcher = pattern, matcher(document) ; 
wo r d L i s t. reset!); 
whi I e ( mat c her. f i nd( )){ 

wordLi st, add( document . substri ng(matcher. start!) 

ma t c h e r. e n d () )) ; 

} 

return wordLi st. getConcordance! ); 

} 

} 


led only once 


/ 

build 
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9.8 Sample Development— continued 


Notice how short the class is, thanks to the power of pattern matching and the 
helper WordList class. 

We run the program against varying types of input text files. We can use a long 
document such as the term paper for the last term's economy class (don't forget to save it 
as a text file before testing). We should also use some specially created files for testing 
purposes. One file may contain only one word repeated 7 times,for example. Another file 
may contain no words at all. We verify that the program works correctly for all types of 
input files. 


Step 4 Development: Finalize 

program As a l wa Y s ' we finalize the program in the last step. We perform a critical review to find 

review any inconsistency or error in the methods, any incomplete methods, places to add more 

comments, and so forth. 

In addition, we may consider possible extensions. One is an integrated user inter¬ 
face where the end user can view both the input document files and the output word list 
files. Another is the generation of different types of list. In the sample development, we 
count the number of occurrences of each word. Instead, we can generate a list of posi¬ 
tions where each word appears in the document. The WordList class itself needs to be 
modified for such extension. 


Summary 


• The char data type represents a single character. 

• The char constant is denoted by a single quotation mark, for example, 'a'. 

• Thecharacter coding scheme used widely today isASCII (American 
Standard Code for Information Exchange). 

• Java uses Unicode, which is capable of representing characters of diverse 
languages. ASCII is compatible with Unicode. 

• A string is a sequence of characters, and in Java, strings are represented by 
String objects. 

• The Pattern and Matcher classes are introduced in Java 2 SDK 1.4. They 
provide support for pattern-matching applications. 

• Regular expression is used to represent a pattern to match (search) in a given 
text. 

• The string objects are immutable. Once they are created, they cannot be 
changed. 

• To manipulate mutable strings, usestringBuffer. 
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Strings are objects in Java, and the rules for comparing objects apply when 
comparing strings. 

Only one string object is created for the same literal string constants. 

The standard classes described or used in this chapter are 

String Pattern 

StringBuffer Matcher 

StringBuilder 


Key Concepts 


characters 

strings 

string processing 
regular expression 


pattern matching 
character encoding 
string comparison 


Exercises 


Review Exercises 

1. W hat is the difference between 'a' and "a"? 

2. Discuss the difference between 

str = str + word; //string concatenation 

and 

tempStri ngBuffer. append(word) 
where str is a String object and tempStringBuffer is a StringBuffer Object. 

3. Show that if x and y are string objects and x == y is true, then x.equals(y) is 
also true, but the reverse is not necessarily true. 

4. What will be the output from the following code? 

StringBuffer wor dl, wor d 2; 

wo r d 1 = new Stri ngBuffer("Li sa"); 

wo r d 2 = wo r d 1; 

word2.i nsert (0, "Mona " ); 

System, out. pri ntl n(wordl); 

5. Show the state of memory after the execution of each statement in the 
following code. 

String wordl, wo r d 2; 
wo r d1 = "Hello"; 
wo r d 2 = wordl; 
wordl = "Java"; 
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6. Using a state-of-memory diagram, illustrate the difference between a null 
string and an empty string— a string that has no characters in it. Show 
the state-of-memory diagram for the foil owing code. Variable wordi is a 
null string, while word2 is an empty string. 

String wordi, wo r d 2; 
wordi = nul I ; 
wo r d 2 = " 11 ; 

7. D raw a state-of-memory di agram for each of thefol I ow i ng groups of statements. 


String wordi, wo r d 2; 

St r 

i ng 

wordi, wo r d 2; 

wordi = "French Roast"; 

wo r 

dl 

= "French 

Roast 

wo r d 2 = wordi; 

wo r 

d 2 

= "French 

Roast 


8 The Ch9ExtractWords program for extracting words in a given sentence 
includes the test 

if (beginldx != endldx) ... 

Describe the type of input sentences that will resultin thevariables beginldx 
and endldx becoming equal. 

Level 1 Programming Exercises ★ 

9. Writea program that reads in a character and displays the character's ASCII. 
Accept the input as a string data and check the first character. Display an 
error message if more than one character is entered. Repeat the operation 
until the symbol @ (ASCII 64) is entered. 

10. Write a program that reads a sentence and prints out the sentence in reverse 
order using the reverse method of the stringBuffer class. For example, the 
method will display 

? u o y era wo H 

for the input 

How are you? 

Repeat the operation until an empty string is entered. 

11. Write a program that reads in a sentence and displays the count of 
individual vowels in the sentence. U se any output routine of your 
choice to display the result in this format. Count only the lowercase 
vowels. Repeat the operation until an empty string is entered. 

Vo we I counts for the sentence 
Mary had a little la mb. 

# of 1 a 1 : 4 

# of 1 e 1 : 1 

# of 1 i 1 : 1 

# of 1 o 1 : 0 

# of 1 u 1 : 0 
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12. In the CH9TranscribeDNA program, we used the basic string processing 
approach. Rewrite the program by using the pattern-matching approach. Do 
not use the replaceAll method of the string class. Because we perform the 
transcription operation repeatedly, it is more efficient to use the Pattern and 
Matcher classes directly. Create an appropriate Matcher object before the 
while loop. 

Level 2 Programming Exercises ★★ 

13. Write a program that prints the number of uppercase letters in an input 
string. Use the class method isUpperCase of the Character class, which 
returns true if the passed parameter of type char is an uppercase letter. You 
need to explore the Character class from the java.lang package on your own. 
Repeat the operation until an empty string is entered. 

14. Redo Exercise 13 without using the Character class. Hint: The A SC 11 of any 
uppercase letter will fall between 65 (codefor'A') and 90 (codefor'Z'). 

15. I n the Ch9ReverseDNA program, we used the reverse method Of the String- 
Buffer class to reverse a given DNA sequence (see also Exercise 10). Re¬ 
write the ch9ReverseDNA program without using the reverse method. You 
have to scan the input string and build a new (reversed) string. 

16. Finding the complement of a given DNA strand is another common opera¬ 
tion. The double helix of DNA is composed of two complementary strands. 
Because the base pairs are formed by pairing A with T and G with C, we can 
easily find the complement of a given DNA strand by simple substitutions. 
For example, the complement of GATTCGATC is CTAAGCTAG. Write a 
program that outputs the complement of a given DNA strand. Repeat the 
operation until an empty string is entered. 

17. W rite a program that outputs the reverse complement of a given DNA 
sequence. First you find the reverse of a given DNA sequence (see 
Exercise 15) and then output the complement (see Exercise 16) of the 
reversed sequence. 

18. A codon is a triplet of nucleotides that specifies a single amino acids 
(a protein is a sequence of amino acids). Write a program that outputs 
codons given a DNA (or RNA) sequence. For example, if theinputis 
GATTCGATC, the program outputs GAT, TCG, and ATC. Output one 
codon per line. If the length of an input string is not a multiple of 3, then 
ignore any leftover nucleotides. For example, if the input is GATTCGA, 
then output will be GAT and TCG. Repeat the operation until an empty 
string is entered. 

19. Write a program that reads a sentence and prints out the sentence with all 
uppercase letters changed to lowercase and all lowercase letters changed to 
uppercase. Repeat the operation until an empty string is entered. 

20. Write a program that transposes words in a given sentence. For example, 
given an input sentence 

The gate to Java nirvana is near 
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the method outputs 

ehT etag ot avaj anavrin si raen 

Repeat the operation until an empty string is entered. To simplify the 
problem, you may assume the input sentence contains no punctuation marks. 
You may also assume that the input sentence starts with a nonblank character 
and that there is exactly one blank space between the words. 

21. Write a program that determines if an input word is a palindrome. A 
palindrome is a string that reads the same forward and backward, for 
example, noon and madam. Ignore the case of the letter. So, for example, 
maDaM, MadAm, and mAdaM are all palindromes. Repeat the operation 
until an empty string is entered. 

Level 3 Programming Exercises ★★★ 

22. Improve the program in Exercise 20 by removing the assumptions. For 
example, an input sentence could be 

Hello, how are you? I use JDK 1.2.2. Bye-bye, 

An input sentence may contain punctuation marks and more than one blank 
space between two words. Transposing the above will result in 

oI I eH, woh era uoy? I esu KDj 1.2.2. eyB-eyb. 

Notice the position of punctuation marks does not change and only one 
blank space is inserted between the transposed words. 

23. The Ch9CountWords program that counts the number of words in a 
given sentence has a bug. If the input sentence has one or more blank 
spaces at the end, the value for wordCount will be 1 more than the 
actual number of words in the sentence. Correct this bug in two ways: 
one with the trim method of the string class and another without using 
this method. 

24. Write a program that determines if an input sentence is a palindrome, for 
example, A man, a plan, a canal, Panama! You ignore the punctuation 
marks, blanks, and case of the letters. Repeat the operation until an empty 
string is entered. 

Development Exercises 

For the following exercises, use the incremental development methodology to 
implement the program. For each exercise, identify the program tasks, create a 
design document with class descriptions, and draw the program diagram. M ap 
out the development steps at the start. Present any design alternatives and 
justify your selection. Be sure to perform adequate testing at the end of each 
development step. 

25. Write an Eggy-Peggy program. Given a string, convert itto a new string by 
placing egg in front of every vowel. For example, the string 

I Love j ava 
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becomes 

eggl Leegoveege jeegaveega 

26. Write a variation of the Eggy-Peggy program. Implement the following four 
variations: 

• sha Add sha to the beginning of every word. 

• Na A dd na to the end of every word. 

• sha Na Na Add sha to the beginning and na na to the end of every 

word. 

• Ava M ove the first letter to the end of the word and add ava 

to it. 

Allow the user to select one of four possible variations. 

27. Write a word guessing game. The game is played by two players, each 
taking a turn in guessing the secret word entered by the other player. Ask the 
first player to enter a secret word. After a secret word is entered, display a 
hint that consists of a row of dashes, one for each letter i n the secretword. 
Then ask the second player to guess a letter in the secretword. If the letter is 
in the secret word, replace the dashes in the hint with the letter at all 
positions where this letter occurs in the word. If the letter does not appear in 
the word, the number of incorrect guesses is incremented by 1. The second 
player keeps guessing letters until either 

• The player guesses all the letters in the word. or 

• The player makes 10 incorrect guesses. 

Here's a sample interaction with blue indicating the letter entered by the player: 

s 

A 

- A - A 

V 

- A V A 

D 

- A V A 

J 

JAVA 

Bingo! You won. 

Support the following features: 

• Accept an input in either lowercase or uppercase. 

• If the player enters something other than a single letter (a digit, special 
character, multiple letters, etc.), display an error message. The number 
of incorrect guesses is not incremented. 

• If the player enters the same correct letter more than once, reply with 
the previous hint. 
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• Entering an incorrect letter the second time is counted as another 
wrong guess. For example, suppose the letter w is not in the secret 
word. Every time the player enters w as a guess, the number of 
incorrect guesses is incremented by 1. 

After a game is over, switch the role of players and continue with 
another game. When it is the first player's turn to enter a secret word, give 
an option to the players to stop playing. Keep the tally and announce the 
winner at the end of the program. The tally will include for each player the 
number of wins and the total number of incorrect guesses made for all 
games. The player with more wins is the winner. In the case where both 
players have the same number of wins, the one with the lower number of 
total incorrect guesses is the winner. If the total numbers of incorrect guesses 
for both players are the same also, then it is a draw. 

28. Write another word guessing game similar to the one described in Exercise27. 
For this word game, instead of using a row of dashes for a secret word, a 
hint is provided by displaying the letters in the secret word in random order. 
For example, if the secret word is COM PUTER, then a possible hint is 
MPTUREOC.The player has only one chance to enter a guess. The player 
wins if he guessed the word correctly. Time how long the player took to 
guess the secret word. After a guess is entered, display whether the guess is 
corrector not. If correct, display the amount of time in minutes and seconds 
used by the player. 

The tally will include for each player the number of wins and the total 
amount of time taken for guessing the secret words correctly (amount of 
time used for incorrect guesses is not tallied). The player with more wins 
is the winner. In the case where both players have the same number of wins, 
the one who used the lesser amount of time for correct guesses is the winner. 
If the total time used by both players is the same also, then it is a draw. 

29. The word game Eggy-Peggy is an example of encryption. Encryption has 
been used si nee ancient times to communicate messages secretly. One of the 
many techniques used for encryption is called a Caesar cipher. With this 
technique, each character in the original message is shifted N positions. For 
example, if AT = 1, then the message 

I drink only decaf 

becomes 

J!esjol!pomz!efdbg 

The encrypted message is decrypted to the original message by shifting back 
every character positions. Shifting positions forward and backward is 
achieved by converting the character to ASCII and adding or subtracting N. 
Write an application that reads in the original text and the value for Wand 
displays the encrypted text. Make sure the ASCII value resulting from 
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encryption falls between 32 and 126. For example, if you add 8 (value of N) 
to 122 (ASCII code for 'z'), you should "wrap around" and get 35. 

Write another application that reads the encrypted text and the value 
for N and displays the original text by using the Caesar cipher technique. 
Design a suitable user interface. 

30. Another encryption technique is called a Vignere cipher. This technique is 
similar to a Caesar cipher in that a key is applied cyclically to the original 
message. For this exercise a key is composed of uppercase letters only. 
Encryption is done by adding the codevalues of the key's characters to the 
code values of the characters in the original message. Code values for the 
key characters are assigned as follows: 0 for A, 1 for B, 2 for c, ..., and 
25 for z. Let's say the key is coffee and the original message is i drink 
only decaf. Encryption works as follows: 


I drink only decaf 
+ + + + ... + 
COFFEECOFFEECOFFEE 


t t t t 

i W 


K 




Decryption reverses the process to generate the original message. Write an 
application that reads in a text and displays the encrypted text. M ake sure the 
ASCII value resulting from encryption or decryption falls between 32 and 
126. You can get the code for key characters by (int) keyChar - 65. 

Write another application that reads the encrypted text and displays the 
original text, using the Vignere cipher technique. 

31. A public-key cryptography allows anyone to encode messages while only 
people with a secret key can decipher them. In 1977, Ronald Rivest, Adi 
Shamir, and Leonard Adleman developed a form of public-key cryptography 
cal I ed the RSA system. 

To encode a message using the RSA system, one needs n and <?. The 
value« is a product of any two prime numbers p and q. The values is any 
number less than n that cannot be evenly divided into _y (that is ,y + e would 
have a remainder), where y = (p - 1) x (q - 1). The values n and e can be 
published in a newspaper or posted on the Internet, so anybody can encrypt 
messages. The original character is encoded to a numerical values by using 
the formula 


c = m e mod n 

where/?! is a numerical representation of the original character (for example, 
1 for A, 2 for B, and so forth). 
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Now, to decode a message, one needs d. The valuer/ is a number that 
satisfies the formula 


e ■ d mod y = 1 

where e and y are the values defined in the encoding step. The original 
character m can be derived from the encrypted character c by using the 
formula 

m = c d mod n 

Write a program that encodes and decodes messages using the RSA system. 
Use large prime numbers for p and <7 in computing the value for n, because 
when p and q are small, it is not that difficult to find the value of d. When p 
and <7 are very large, however, itbecomes practically impossibleto 
determi ne the val ue of c/. U se the ASCII val ues as appropri ate for the 
numerical representation of characters. Visit http://www.rsasecurity.com for 
more information on how the RSA system is applied in the real world. 
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Objectives 

After you have read and studied this chapter, you 
should be able to 

• Manipulate a collection of data values, using 
an array. 

• Declare and use an array of primitive data 
types in writing a program. 

• Declare and use an array of objects in writing a 
program. 

• Define a method that accepts an array as its 
parameter and a method that returns an array. 

• Describe how a two-dimensional array is 
implemented as an array of arrays. 

• Manipulate a collection of objects, using lists 
and maps. 
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Introduct 




eople collect all sorts of items from bottle caps to exotic cars. For proof, just go to 
eBay (www.ebay.com) and see millions and millions of collectibles up for auction. 
With computers, people amass intangible items such as music files. Exactly how 
many M P3 files do you have on your computer? Probably in the hundreds and you 
lost track of exactly how many. You may wantto develop a custom software, so you 
can store the information you want in the format you like, to keep track of all M P3 
files downloaded from the Web. 

When we write a program to deal with a collection of items, say, 500 student 
objects, 200 integers, 300 M P3 files, and so forth, simple variables will not work. It 
is just not practical or feasible to use 500 variables to process 500 student objects. 
In theory, you can, but honestly, do you wantto type in identifiers for 500 variables 
(studenti, student2, , . .)? A feature supported by programming languages to ma¬ 
nipulate a collection of values is an array. 

In this chapter we will learn about Java arrays. We will learn the basics of 
array manipulation and how to use different types of arrays properly and effec¬ 
tively. In addition, we will study several collection classes from the java.util 
package that provide more advanced data management features not found in the 
basic Java arrays. 


10.1 Array Basics 

Suppose we wantto compute the annual average rainfall from 12 monthly averages. 
We can use three variables and compute the annual average as follows (in this and 
other code fragment examples, we assume scanner is a properly declared and cre¬ 
ated Scanner object): 

double sum, rainfall, annualAverage; 
sum = 0.0; 

for ( i nt i =0; i <12; i ++) { 

System, out. pri nt("Rai nfal I for month " + (i+1) + "); 

rainfall = scanner.next Doublet); 

sum += rainfall; 

} 

annualAverage = sum / 12.0; 

Now suppose we want to compute the difference between the annual and 
monthly averages for every month and display a table with three columns, similar 
to the one shown in Figure 10.1. 
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Annual Average Rainfall: 

15.03 mm 

M onth 

Average 

Variation 

1 

13.3 

1.73 

2 

14.9 

0.13 

3 

14.7 

0.33 

4 

23.0 

7.97 

5 

25.8 

10.77 

6 

27.7 

12.67 

7 

12.3 

2.73 

8 

10.0 

5.03 

9 

9.8 

5.23 

10 

8.7 

6.33 

11 

8.0 

7.03 

12 

12.2 

2.83 


Figure 10.1 Monthly rainfall figures and their variation from the annual average. 

To compute the difference between the annual and monthly averages, we need 
to remember the 12 monthly rainfall averages. Without remembering the 12 monthly 
averages, we won't be able to derive the monthly variations after the annual average 
is computed. Instead of using 12 variables januaryRainfall, februaryRainfall, and so 
forth to solve this problem, we use an array. 

array A n array is a collection of data values of the same type. For example, we may 

declare an array consisting of double, but not an array consisting of both int and 
double. The following declares an array of double: 

double!] rainfall; 

array The square brackets i ndicate the array declaration. The brackets may be attached to 

declaration a variable instead of the data type. For example, the declaration 

double rainfall!]; 

is equivalent to the previous declaration. In Java, an array is a reference data type. 
Unlike the primitive data type, the amount of memory allocated to store an array 
varies, depending on the number and type of values in the array. We use the new 
operator to al locate the memory to store the val ues i n an array. A Ithough we use the 
same reserved word new for the array memory allocation as for the creation of a 
new instance of a class, strictly speaking, an array is notan object. 


iThings to Remember 



In Java, an array is a reference data type. I/I le need to use the new operator to allo¬ 
cate the memory for an array. 
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rainfall 


double[] rainfall = new doubl e[ 12] ; 



rainfal l[2] 


This is an indexed expression 
referring to the element at 
position 2, that is, the third 
element of the array. 


Figure 10.2 An array of 12 double values. 


The following statement allocates the memory to store 12 double values and asso¬ 
ciates the identifier rainfall to it. 

rainfall = new double[12]; II create an array of size 12 

Figure 10.2 shows this array. 

We can also declare and allocate memory for an array in one statement, as in 

doublet] rainfall = new double [ 12]; 

The number 12 designates the size of the array— the number of val ues the array con- 
indexed tains. We use a single identifier to refer to the whole collection and use an indexed 

expression expression to refer to the individual values of the collection. An individual value in 

an array is called an array element. Zero-based indexing is used to indicate the po¬ 
sitions of an element in the array. They are numbered o, i, 2,.... and size - 1 , where 
size is the size of an array. For example, to refer to the third element of the rainfall 
array, we use the indexed expression 

r a i nf a I I [ 2 ] 

Instead of a literal constant such as 2 , we can use an expression such as 

r a i nf a I I [ i +3] 

Notice that the index for the first position in an array is zero. As for a string 
object, J ava uses zero-based indexing for an array. 


Lj^ings to Remember 

The index of the first position in an array is 0. 
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rainfall 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

24.5 

32.7 

/ \ 

28.6 

18.3 

12.5 

24.8 

9.5 

4.5 

5.5 

12.5 

24.5 

27.2 



v -/ 











rainfall [2] == 28.6 


Figure 10.3 An array of 12 double values after all 12 are assigned values. 

Using the rainfall array, we can input 12 monthly averages and compute the 
annual average as 

doublet] rainfall = new doubl e[12]; 

double annual Average, 

sum = 0.0; 

for ( i nt i =0; i <12; i ++) { 

System, out. pri nt("Rai nfal I for month " + (i+1) + "); 

r ai n f a I I [i ] = scanner. nextDoubl e( ) ; 

sum += rainfall[i]; 

} 

annual Average = sum / 12.0; 

Figure 10.3 shows how the array will appear after all 12 values are entered. 

After the 12 monthly averages are stored in the array, we can print out the 
table (alignment of the columns is not done here, but will be in the complete 
program listing). 

double difference; 

for ( i nt i =0; i <12; i ++) { 

System, out. pri nt(i +1); //month # 

//average rainfall for the mo nth 
System, out. print!" " + rai nfal I [i ]); 

//difference between the monthly and annual averages 

difference = Math, a b s ( rai nfalI [i ] - annua I Average ); 
System, out. pri ntl n(" " + difference); 

} 

Here's the complete program: 


Can also be declared as 

doubl e rainfall]] 

= new doubl e[ 12] 



Chapter 10 Sample Program: Compute the annual average rainfall 

and the variation from monthly average. 


File: ChlORainfall.java 

*/ 
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w 

import java.util.*; 
class Ch10Rainfall { 

public static void main (String!] args) { 

Scanner scanner = new Scanner (System, in); 

double!] rainfall = new double[12]; 

double annualAverage, 
s urn, 

di f f e r e nc e; 
sum = 0.0; 

for ( i nt i =0; i <12; i ++) { 

System, out. pri nt("Rai nfal I for mo n t h " + ( i +1 ) + ": " 
r ai n f a I I [i ] = scanner, next Doubl e(); 

sum += r a i nf a I I [ i ] ; 

} 

annualAverage = sum / 12.0; 

System, out . format! "Annual Average R a i nfal I : %5. 2 f \ n \ n" , 

annualAverage); 

for ( i nt i =0; i <12; i ++) { 

System, out. format( " %3 d " , i+1); //month # 

//average rainfall for the mo nth 
System, out. format(" %15. 2 f" , r a i n f a I I [ i ]) ; 

//difference between the monthly and annual averages 
difference = Math, a b s ( rainfallji] - annualAverage ); 
System. out.format(" %15. 2 f \ n " , difference); 

} 

} 

} 


Notice that the values displayed in the columns are aligned by formatting the string, 
length An array has a public constant length for the size of an array. Using this con¬ 

stant, we can rewrite the for loop as 

for ( i nt i = 0; i < r ai nfalI.I ength; i ++) { 

} 
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T hi s for Ioop i s more general si nee we do not have to modify the I oop statement w hen 
the size of an array is changed. A Iso, the use of length is necessary when the size of 
an array is not known in advance. This happens, for example, when we write a method 
with an array as its parameter. We will provide an example of such a method in 
Section 10.3. 

Notice the prompts for getting the values in the previous example are Rainfall 
for month i, Rainfall for month 2, and so forth. A better prompt will spell out the 
month name, for example, Rainfall for January, Rainfall for February, and SO forth. 
We can easily achieve a better prompt by using an array of strings. Here's how: 


doublet] rainfall = new d o u b I e [ 12] ; 

String]] monthName = new S t r i n g [ 12 ] 
double annual Average, 


s u m 

= 0.0; 

mo n t h N a me [ 0 ] 

= "January"; 

mo n t h N a me [ 1 ] 

= "February"; 

mo n t h N a me [ 2 ] 

= “March"; 

mo n t h N a me [ 3 ] 

= "April"; 

mo n t h N a me [ 4 ] 

= "May"; 

mo n t h N a me [ 5 ] 

= “June"; 

mo n t h N a me [ 6 ] 

= "July"; 

mo n t h N a me [ 7 ] 

= "August"; 

mo n t h N a me [ 8 ] 

= " S e p t e mb e r" 

mo n t h N a me [ 9 ] 

= "October"; 

mo n t h N a me [ 1 0 ] 

= "November"; 

mo n t h N a me [ 11 ] 

= “December"; 

for (int i = 

0; i < r a i nf a 1 


an array of double 
an array of String 


engt h; i ++) { 

System, out. print] "Rainfall for mo nth" + 
mo n t h N a me [i ] + ": " ); 
r a i nf a I I [ i ] = s c a nner. next Dou bl e( ); 

sum += rai nfalI [i]; 


} 


annual Average = sum / 12.0; 



It is very easy to mix up the length value of an array and the length method of a 
String object. The length is a method for a String object, so we use the syntax for 
calling a method. 

String str = "This is a string"; 
int size = str. length]); 

But for an array, which is not an object but a reference data type, we do not use the 
syntax of method calling. We refer to the length value as 

int size = rainfall.length; 
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Instead of assigning array elements individually, wecan initialize the array at 
the time of declaration. We can, for example, initialize the monthName array by 

String!] monthName = { "January", "February", "March", 

"April", "May", "June", "July", 
"August", "September", "October", 
"November", "December" } ; 

N oti ce that we do not specify the si ze of an array i f the array el ements are i ni ti al i zed 
at the time of declaration. The size of an array is determined by the number of val¬ 
ues i n the I i st. I n the above exampl e, there are 12 val ues i n the I i st, so the si ze of the 
array monthName is set to 12. 

Let's try some more examples. We assume the rainfall array is declared, and 
all 12 values are read in. The following code computes the average rainfall for the 
odd months (January, M arch,...) and the even months (February, April,...). 

double oddMont hSum, oddMont hAver age, 

evenMonthSum, evenMont hAver age; 

oddMont hSum = 0.0; 
evenMont hSum = 0.0; 

//compute the average for the odd months 

for ( i nt I = 0; i < ra i nfa I I . I ength; i += 2) { 

oddMont hSum += r ai nf alI [i]; 

} 

oddMonthAverage = oddMonthSum / 6.0; 

//compute the average for the even months 

for ( int i = 1; i < rai nfa I I .I ength ; i += 2) { 

evenMonthSum += rai nfalI [i ]; 

} 

evenMonthAverage = evenMonthSum/ 6.0; 

We can compute the same result by using one for loop. 

for ( int i = 0; I < rai nfa I I.I ength; i += 2 ) { 

oddMonthSum += rai nfal I [i ]; 
evenMonthSum += rai nfa I I [i +1 ] ; 

} 

oddMonthAverage = oddMonthSum/ 6.0; 
evenMonthAverage = evenMonthSum/ 6.0; 

To compute the average for each quarter (quarter 1 has J anuary, F ebruary, and 
M arch; quarter 2 has April, M ay, and J une; and so forth), wecan write 

for ( i nt i =0; i <3; iff) { 

quarterlSum += rai nfalI [ i ] ; 
quarter2Sum += rai nfalI [i +3]; 
quarter3Sum += rai nfalI [i +6]; 
quarter4Sum += rai nfalI [i +9]; 

} 


No size is specified. 
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quarterlAverage = quarterlSum / 3.0; 

quar t er 2Aver age = quar t er 2Sum / 3.0; 

qua r t e r 3 Aver age = qua r t e r 3 Su m / 3.0; 

q u a r t e r 4 Av e r a g e = quarter4Sum / 3.0; 

We can use another array to store the quarter averages instead of using four variables: 

double!] quarterAverage = new d o u b I e [ 4 ] ; 
for ( i nt i =0; i <4; i + + ) { 
sum = 0; 

for ( i nt j = 0; j < 3; j ++) { //compute the sum of 
sum += rai nfal I [3*i + j]; II one quarter 

} 

quarterAverage [ i ] = sum / 3.0; //average for quarter i +1 

} 

Notice how the inner for loop is used to compute the sum of one quarter. The fol¬ 
lowing table illustrates how the values for the variables i and j and the expression 
3*i + j change. 



H ere's the complete program: 


/ * 

Chapter 10 Sample Program: Compute different statistics 

frommonthly rainfall averages. 


File: ChlORai nfalI Stat.j ava 

*/ 
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import java,util.*; 

class ChlORai nf alI St at { 

public static void mai n(Stri ng[] args) { 

Scanner scanner = new Scanner(System. in); 

String)] mo n t h N a me = { "January", "February", 

“April", "May" , "June" 

"August", " S e p t e mb e r" , 

"November", "December" 

double!) rainfall = new d o u b I e [ 12] ; 

double!] quarterAverage = new d o u bIe [ 4 ] ; 

double annual Average, 

s u m, 

di f f e r e nc e; 

double oddMont hSum, oddMont hAver age, 

evenMont hSum, evenMont hAver age; 

sum = 0.0; 

for ( i nt i = 0; i < ra i nfa I I . I ength; i ++) { 

System, out. print! "Rainfall for mo nth " + mo n t h N a me [ i ] + " 
r a i nf a I I [ i ] = s c a n n e r. n ex t Do u bl e ( ); 

sum += r ai nf a I I [ i ]; 

} 

annualAverage = sum / 12.0; 

S y s t e m. o u t. f o r ma t ( "Annual Average R a i n f a I I : %6. 2 f \ n \ n " , 

annualAverage ); 

oddMont hSum = 0.0; 
evenMont hSum = 0.0; 

///////////// Odd and Even Month Averages ////////////////// 

//compute the average for the odd months 
for ( i nt i = 0; i < rai nfal I . I ength; i += 2) { 

oddMont hSum += rai nfalI [i]; 

} 

oddMonthAverage = oddMonthSum / 6.0; 

//compute the average for the even months 
for ( i nt i = 1; i < rai nfalI.I ength; i += 2) { 

evenMont hSum += r ai nf alI [ i ] ; 

} 


"March", 

"J ul y\ 

"October", 

}; 
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} 

} 


fixed-size array 
declaration 


evenMont hAver age = evenMonthSum / 6.0; 

System, out. format("Odd Month Rainfall Average: %6.2f\n", 

oddMont hAverage ); 

System, out. format("Even Month Rainfall Average: %6. 2 f \ n \ n", 

evenMont hAver age ) ; 


/////////////////// Quarter Averages ////////////////////// 

for ( i nt i =0; i <4; i + + ) { 
sum = 0; 

for ( i nt j = 0; j < 3; j ++) { //compute the sum of 
sum += rainfall[3*i + j ] ; //one quarter 

} 

quarterAverage [ i ] = sum / 3.0; //average for quarter i+1 

System, out. format("Rai nfal I Average Qt r. %3 d: %6. 2 f \ n" , 

i+1, quarter A v e r a g e [ i ] ); 


} 


In the previous examples, we used a constant to specify the size of an array, 
such as the literal constant 12 in the following declaration: 

double!] rainfall = new d 0 u b I e [ 12 ] ; 

U sing constants to declare array sizes does not always lead to efficient space usage. 
We call the declaration of arrays with constants a fixed-size array declaration. There 
are two potential problems with fixed-size array declarations. Suppose, for exam¬ 
ple, we declare an integer array of size 100: 

int[] number = new i n t [ 10 0 ] ; 

The first problem is that the program can process only up to 100 numbers. W hat 
if we need to process 101 numbers? We have to modify the program and compile 
it again. The second problem is a possible underutilization of space. The above de¬ 
claration allocates 100 spaces whether they are used or not. Suppose the program 
on average processes 20 numbers. Then the program's average space usage is 
only 20 percent of the allocated space. With Java, we are not limited to fixed-size 
array declaration. We can declare an array of different size every time we run the 
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program. The following code prompts the user for the size of an array and de¬ 
clares an array of designated size: 

i nt size; 

i nt [ ] n u mb e r; 

System, out. print! "Size of an array: "); 

size = scanner, nextl nt(); 

number = new int [ si ze ]; 

With this approach, every time the program is executed, only the needed 
amount of space is allocated for the array. Any valid integer arithmetic expression 
is allowed for size specification, for example, 

System, out. print! "Enter i n t: "); 

size = scanner, nextl nt(); 

number = new i ntfsi ze*si ze + 2* size + 5]; 

variable-size We call the creation of arrays with nonconstant values a variable-size array creation. 

array creation t his capability comes very handy, for example, when an array runs out of space and 

we need to create a new, larger array. Suppose we start with an array of 20 elements. 
What would happen when we had to add the 21st element? We can create a new, 
larger array, say, twice as large as the original array. We then copy the values from 
the original array to the new array and finally add the 21st element to the new array. 
We will show you a concrete example of this scenario in Section 10.7. 



Notice the first index position of an array is 0. Java adopted this feature from the 
programming language C. Using the zero-based indexing, the index value of an 
element indicates the number of elements in front of the element. For example, an 
index value of 0 for the first element indicates that there are zero elements in front 
of it; an index value of 4 for the fifth element indicates that there are four elements 
in front of it. Zero-based indexing allows a simpler formula to compute the actual 
memory address of array elements. 


1. Which of the following statements are invalid? 

a. float n u mb e r [ 2 3 ] ; 

b. float number = { l.Of, 2.Of, 3.Of }; 

c. i nt number; 
number = new Ar r ay [ 23 ]; 

d. i nt [ ] number = [ 1, 2, 3, 4 ]; 


Quick 

CHECK 
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2. Write a code fragment to compute the sum of all positive real numbers stored 
in the following array. 

double!] number = new d o u b I e [ 2 5] ; 

3. Describe the difference between the following two codefragments. 

II code frag me n t 1 

for ( i nt i = 0; i < number. I ength; i ++) { 

if ( i % 2 == 0 ) { 

System, out. printlnf n u mb e r [ i ] ); 

} 

} 

//code frag ment 2 

for ( i nt i = 0; i < number. I ength; i ++) { 

if ( number! i ] % 2 == 0 ) { 

System, out. printlnf n u mb e r [ i ] ); 

} 

} 

10.2 Arrays of Objects 

Array elements are not limited to primitive data types. Indeed, since a string is 
actually an object, we have already seen an example of an array of objects in 
Section 10.1. In this section we will explore arrays of objects in detail. To illustrate 
the processing of an array of objects, we will use the Person class in the following 
examples. We will define this Person class later in the chapter to introduce additional 
object-oriented concepts. Here's the portion of the Person class definition we will 
use in this section: 


Public Methods of the P e r s o n Class 

public i nt get Age ( ) 

Returns the age of a person. Default age of a person is set to 0. 

public char get Gender ( ) 

Returns the gender of a person. The character F stands for female and M for male. 
Default gender of a person is set to the character U for unknown. 

public String get N a me ( ) 

Returns the name of a person. Default name of a person is set to N o t Given. 

public void set Age ( int age ) 

Sets the age of a person. 

public void set Gender ( char gender ) 

Sets the gender of a person to the argument gender. The character F stands for 
female and M for male. The character U designates unknown gender. 

public void setName ( String name ) 

Sets the name of a person to the argument n a me . 
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The following code creates a Person object: 

Person latte; 

latte = new Person! ); 

I a11 e, s et Na me ( " Ms. Latte"); 
latte,set A g e ( 2 0) ; 
latte.setGender('F'); 


System, out. pri 

nt 1 n ( 

" N a me: 

11 + 

latte.getNa me() ); 

System, out, pri 

n 11 n ( 

"Age : 

" + 

latte, get Age () ); 

System, out, pri 

nt 1 n( 

"Sex : 

" + 

1 at t e. get Gender() ); 


Now let's study how we can create and manipulate an array of Person objects. 
A n array of objects is declared and created just as an array of primitive data types 
is. The following are a declaration and a creation of an array of Person objects. 

Person! ] person; //declare the person array 

person = new Person[20) ; //and then create it 

Execution of the above code will result in a state shown in Figure 10.4. 

Notice that the elements, that is, Person objects, are not yet created; only the 
array is created. Array elements are initially null. Since each individual element is 
an object, it also must be created. To create a Person object and set it as the array's 
first element, we write 

person! 0 ] = new Person! ) ; 

Figure 10.5 shows the state after the first Person object is added to the array. 

N oti ce that no data val ues are assi gned to the obj ect yet. T he obj ect has defaul t 
values at this point. To assign data values to this object, we can execute 

person! 0] . set Name ( " Ms. Latte" ); 
person! 0]. setAge ( 20 ); 
person! 0]. setGender! F ); 

The indexed expression 

per son[ 0] 


person 




\ 

Person!] 

person; 

person = 

new Person! 2 0] ; 

V 

y 

2 3 

4 


1 - 


null 


16 17 18 19 


Figure 10.4 An array of Person objects after the array is created. 
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person 



Figure 10.5 The person array with one Person object added to it. 


refers to the first object in the person array. Si nee this expression refers to an object, 
we write 


pe r s on [ 0 ]. s et Age ( 20 ); 

to call this Person object's setAge method, for example. This is the syntax we use to 
call an object's method. We are just using an indexed expression to refer to an ob¬ 
ject instead of a simple variable. 

Let's go through typical array processing to illustrate the basic operations. 
The first is to create Person objects and set up the person array. We assume that the 
person array is already declared and created. 

String name, inpStr; 

int age; 

char gender; 

for ( i nt i = 0; i < person.I ength; i ++) { 

II read in data values 

System, out. pri nt("Enter n a me: " ) ; 

name = scanner, next (); 

System, out, print) "Enter age: "); 
age = scanner. nextlntf); 

System, out, print! "Enter gender: "); 
inpStr = scanner, next!); 
gender = inpStr.char At (0); 

II create a new Person and assign values 

p e r s o n [i ] = new Person! ); 

person[i ]. setName ( name ); 
person[i ]. setAge ( age ); 
pe r s on [i]. set Gender! gender ); 

} 
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find the 
average age 


find the 
youngest and 
the oldest 
persons 


Note: To focus on array processing, we used the most simplistic input routine. For 
instance, we did not perform any input error checking, but this is not to say that input 
error checking is unimportant. We simply want to focus on array processing here. 

To find the average age, we execute 

double sum = 0, average Age; 

for ( int i = 0; i < per son. I engt h; i ++) { 
sum += per so n[ i ] .get Age () ; 

} 

averageAge = sum / person.I ength; 

To print out the name and age of the youngest and the oldest persons, we can 
execute 


String n a meOf Yo u ng es t, nameOfOl dest; 
i n t min, ma x, age; 

na me Of Yo u n ge s t = nameOfOldest = pe r s o n [ 0 ]. ge t Na me ( ); 
min = max = person[0].getAge(); 

for ( i nt i = 1; i < person.I ength; i ++) { 
age = per son[i ], get Age (); 

if (age < min) { //found a younger person 

mi n = a g e; 

name Of Youngest = person[i].getName(); 

} e I s e if (age > max) { //found an older person 
ma x = a g e; 

nameOfOldest = p e r s o n [ i ] . g e t Na me () ; 

} 

} 

System, out. pri ntl n("OI dest : " + nameOfOldest + " is " 

+ ma x + " years old,' 1 ); 

System, out. pri ntl n ( " Youngest: 11 + name Of Youngest + " is " 

+ mi n + " years old,"); 

Instead of using separate string and int variables, we can use the index to the 
youngest and the oldest persons. H ere's the code: 

int minldx, //index to the youngest person 

maxldx; //index to the oldest person 

minldx = maxldx = 0; 

for (int i = 1; i < per son.Iength; i ++) { 

if (person[i].getAge() < person! mi nldx].getAge()) { 

//found a younger person 
mi n I d x = i ; 
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} eIs e if (person[i].getAge() > person! maxi dx, getAgef ) ){ 

//found an older person 
ma x I d x = i ; 

} 

} 

System, out. pri ntl n("OI dest : " + pe r s o n [ ma x I d x ] . g e t Na me () 

+ ' is " 

+ person! maxi dx]. getAge( ) 

+ " years old."); 

System, out. pri ntl n ( " Youngest: " + person! ml nl dx]. get Name () 

+ " is " 

+ person! ml nl dx] . getAge( ) 

+ " years old,"); 

Yet another approach is to use variables for Person objects. Figure 10.6 shows 
how the Person variables oldest and youngest point to objects in the person array. 
H ere's the code using Person variables: 

Person youngest, //points to the youngest person 

oldest; //points to the oldest person 

youngest = ol dest = p e r s o n [ 0 ] ; 

for ( i nt i = 1; i < person.I ength; i ++) { 

if ( per son[i ] . get Age( ) < youngest,get A g e ()) { 

//found a younger person 
youngest = person! i ] ; 

} 


person 0 1 2 3 4 16 17 18 19 



oldest youngest 


Figure 10.6 An array of Person objects with two Person variables. 
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find a particu¬ 
lar person 


else if ( per son[i]. get Age( ) > ol dest.get A g e ()) { 

//found an older person 
oldest = person! i ] ; 

} 

} 

System, out. printing Oldest : 11 + oldest. getNa me () 

+ " is 11 + ol dest. get Age( ) + 11 years old,"); 

System, out. printlnf" Youngest: 11 + youngest.getNa me () 

+ " is “ + youngest. getAgef ) + “ years old,' 1 ); 

Our next example is to search for a particular person. We can scan through the 
array until the desired person is found. Suppose we want to search for a person 
whose name is Latte. If we assume the person is in the array, then we can write 

i nt i = 0; 

while (! person)i ] . getName() . equal s( "Latte") ) { 
i ++; 

} 

System, out. pri ntl n( " Found Ms. Latte at position " + i); 

The expression 

person[i ] . getName() . equal s( "Latte") 

is evaluated left to right and is equivalent to 

Person p = p e r s o n [i ]; 

String s t r = p.getName (); 

s t r, e q u a I s ( 11 L a 11 e 11 ) ; 

In this example, we assume that the person for whom we are searching is in 
the array. If we cannot assume this, then we need to rewrite the terminating condi¬ 
tion to take care of the case when the person is not in the array. Here's how: 

i nt i =0; 

while (i < per son.I ength &&//stll! more persons to search 
! p e r s o n [ i ]. g e t N a me ( ), e q u a I s ( 11 L a 11 e 11 )) { 
i ++; 

} 

if (I == person. length) { 

II not found - unsuccessful search 

System, out. pri ntl n("Ms. Latte was not in the array”); 

} else { 

//found - successful search 

System, out. pri ntl n ( " Found Ms. Latte at position 11 + i); 

} 


www.it-ebooks.info 


10.2 Arrays of Objects 573 


H ere's the complete program that summarizes the topics covered so far in this 
section: 


Chapter 10 Sample Program: Illustrate the processing 

of an array of Person objects 

FiIe: ChlOProcessPersonArray.j ava 

*/ 

import java.util.*; 

class Ch 10ProcessPersonArray { 

public static void main (String!] args) { 

Person!] person; //declare the person array 

person = new P e r s o n [ 5 ]; II and then create it 

II . Create person Array . II 

String name, inpStr; 

i nt age; 

char gender; 

for ( int i = 0; i < per son.I ength; i ++) { 

II read in data values 

System, out. pri nt("Enter n a me: " ) ; 

name = scanner, next!); 

System, out. print! “Enter age: "); 
age = scanner, nextl nt(); 

System, out. print! "Enter gender: "); 
inpStr = scanner, next!); 
gender = inpStr. char At (0); 

II create a new Person and assign values 

per son[i] = new Person! ) ; 

person! i ] . setName ( name ); 
person! i ]. setAge ( age ); 

person!i ]. setGender! gender ); 

} 

II . Comput e Average Age . II 

f I oat s urn = 0, aver ageAge; 
for ( i nt i = 0; i < per son.Iength; i ++) { 
sum += pe r s on [ i ]. get Age (); 

} 
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aver ageAge = sum / (float) person.Iength; 

System, out. pri ntl n("Average age: " + averageAge) ; 

System, out. pri ntl n("\n"); 

II . Find the youngest and oldest persons . II 

II . Approach No. 3: Using person reference . II 

Person youngest, //points to the youngest person 

oldest; //points to the oldest person 

youngest = oldest = pe r s on [0] ; 

for ( i nt i = 1; i < person.I ength; i ++) { 

if ( person! i ]. get A g e () < youngest. getAge ()) { 

//found a younger person 
youngest = per son[ I ] ; 

} 

else if ( per son[i], get A g e () > ol dest.get A g e ()) { 

//found an older person 
oldest = person! i ]; 

} 

} 

System, out. pri ntl n("OI dest : " + oldest,getNa me () 

+ " is " + oldest, g e t A g e () + " years old,"); 

System, out. pri ntl n ( " Youngest: " + youngest,getName () 

+ " is " + youngest. getAge!) + " years old,"); 

II . Search for a particular person .// 

System, out. print! "Na me to search: "); 

String searchName = scanner, next ( ) ; 

i nt i =0; 

while (i < person.length && //still more persons to search 
! person[i ]. getName(). equal s(searchName)) { 
i ++; 

} 

if (i == per son.I engt h) { 

II not found - unsuccessful search 

System, out. pri ntl n( searchName + " was not in the array" ); 

} else { 

//found - successful search 

System, out, pri ntl n (" Found " + searchName + "at position" +1); 

} 

} 

} 
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i nt delldx = 1; 
person[delldx] = nul I , 


person 


Before 


person 


After 


Remove this 




Figure 10.7 Approach 1 deletion: setting a reference to null. The array length is 4. 


de i etea Now let's consider the deletion operation. The deletion operation requires 

particular some kind of a search routine to locate the Person object to be removed. To concen- 

person trate on the deletion operation, we will assume there's a search method that returns 

the index of the Person object in the array to be removed. There are two possible 
ways to remove an object from the array. The first approach is to reset the array el¬ 
ement to null. Remember that each element in an array of objects is a reference to 
an object, so removing an object from an array could be accomplished by setting the 
reference to null. Figure 10.7 illustrates how the object at position 1 is deleted by 
using approach 1. 

With approach 1, any index position can be set to null, so there can be "holes," 
that is, null references, anywhere in the array. Instead of intermixing real and null 
references, the second approach will pack the elements so that the real references 
occur at the beginning and the null references at the end: 


Real references null references 



With approach 2, we must fill the hole. There are two possible solutions. 
The first solution is to pack the elements. If an object at position J is removed 
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i nt delldx = 1; 
i nt last = 3; 

person!delldx] = person!last] ; 
person[last] = nul I ; 


person Before 



Remove this 


person A f ter 



Figure 10.8 Approach 2 deletion: replace the removed element with the last element in the array. The array 
length is 4. 


(i.e., this position is set to null), then elements from position j+i up to the last non¬ 
null reference are shifted one position lower. And, finally, the last non-null reference 
is set to null. The second solution is to replace the removed element by the last ele¬ 
ment in the array. The first solution is necessary if the Person objects are arranged 
in some order (e.g., in ascending order of age). The second solution is a better one 
if the Person objects are not arranged in any order. Since we are not arranging them 
in any order, we will use the second solution. Figure 10.8 illustrates how the object 
at position 1 is replaced by the last element. 

The search routine we presented earlier in this section assumes the full array; 
that is, all elements are non-null references. With the deletion routine, either ap¬ 
proach 1 or 2, given above, an array element could be a null. The search routine 
must therefore be modified to skip the null references (for approach 1) or to stop the 
search when the first null reference is encountered (for approach 2). 

In both Figures 10.7 and 10.8, we removed the icon for Person B in the 
diagrams when the array element was set to null as though the object were erased 
from the memory. Eventually, the object will indeed be erased, but the operation 
of assigning null to the array element will not erase the object by itself. The opera¬ 
tion simply initiates a chain reaction that will eventually erase the object from the 
memory. 

As we have shown several times already, a single object can have multiple ref¬ 
erences pointing to it. For example, the following code will result in two references 
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garbage 

collection 

w 

Quick 

CHECK 


pointing to a single Person object: 

Person pi, p2; 

pi = new Person!); 
p2 = pi; 


Pi 


P2 


Person 


When an object has no references pointing to it, then the system will erase the object 
and make the memory space available for other uses. We call the erasing of an 
object deallocation of memory, and the process of deallocating memory is called 
garbage collection. Garbage collection is done automatically in Java, but in other 
programming languages, such as C++, you must include a statement in the program 
to deallocate memory. 


1. Which of these statements are invalid? 

a. Person[25] person; 

b. P e r s o n [ ] person; 

c. Person person!) = new P e r s o n [ 2 5 ] ; 

d. Person person! 25] = new P e r s o n [ 2 5 ]; 

2. W rite a code fragment to print out the names of those who are older than 20. 
Assume the following declaration and that the array is already set up correctly. 

Person! ] friend = new Person! 100]; 


10.3 The For-Each Loop 

I n C hapter 6, we mentioned a new form of the for I oop that is i ntroduced i n J ava 5.0. 
There is no official name to this for loop, but the term far-each is used most often. 
The term enhanced for loop is also used by many to refer to this for loop. We will 
use both terms interchangeably in this book. 

We will show here how to usethefor-each loop in processing an array. We will 
show how to use it in processing a collection in Section 10.5. Let's assume number 
is an int array of 100 integers. Using the standard for loop, we compute the sum of 
all elements in the number array as follows: 

int sum = 0; 

for (int i = 0; i < number. I ength; i ++) { 
sum = sum + number [ i ] ; 

} 
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By using afor-each loop, wecan compute the sum as follows: 

i nt sum = 0; 

for (int value : number) { 
sum = sum + value; 

} 

The loop iterates over every element in the number array, and the loop body is 
executed for each iteration. The variable value refers to each element in the array 
during the iteration. So we can interpret this loop as saying something like "For 
each value in number, execute the following loop body." 

The general syntax for the for-each loop is 

for ( <type> <v a ri a bI e > : < a r r a y > ) 

<1 oop body> 

where <type> is the data type of <variable>, <array> the name of the array, and 
<loop body> is a sequence of 0 or more statements (the left and right braces are 
required if there is more than one statement in the loop body). 



We cannot use the for-each loop directly to a string to access individual characters 
in it. However, the String class includes a method named toCharArray that 
returns a string data as an array of char data, and we can use the for-each loop on 
this array of char data. Here's an example: 

String s a mp I e = "This Is a test"; 

char[] charArray = sample. toCharArrayl); 
for (char ch: charArray) { 

S y s t e m. o u t. p r i n t ( c h + " " ) ; 

} 

If we do not need to access the char array later, then we can write the code in a 
slightly less verbose way as follows: 

String s a mp I e = "This Is a test"; 

for (char ch: sample. toCharArray(J) { 

S y s t e m. o u t, p r i n t ( c h + " " ); 

} 


Let's look at another example. This time we use an array of objects. Suppose we 
have an array of 100 Person objects called person: 

Person!] person = new Person[100]; 
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The Person class is defined in Section 10.2. Assuming that 100 Person objects are 
created and assigned to person[0] to person[99], we can list the name of every 
person in the array by using the following for-each loop: 

for (Person p : person) { 

System, out, pri ntl n(p. g e t N a me ( ) ) ; 

} 

Contrast this to the standard for loop: 

for ( i nt i = 0; i < person.I ength; i ++) { 

System, out, pri ntl n ( p e r s o n [ i ]. g e t N a me ( ) ) ; 

} 

The for-each loop is, in general, cleaner and easier to read. 

There are several restrictions on using the for-each loop. First, you cannot 
change an element in the array during the iteration. The following code does not 
reset the array elements to 0: 


i nt [ ] number = 
for ( i nt value 
value = 0; 

} 


{10, 20, 30, 40, 50}; 


number ){ 


This loop has no effect. 


for (int value : number) { 
System, out. pri ntl n ( v a I ue); 

} 


The first for-each loop has no effect, so the output from this code will be 


10 

20 

30 

40 

50 

We can characterize the for-each loop as a read-only iteration of the elements. 



The for-each loop only allows access to the elements. The elements cannot 
be changed. 
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For an array of objects, an element is actually a reference to an object, so 
the foil owing for-each loop is ineffective. Specifically, it does not reset the elements 
to null. 


Person!] person = new Person[100]; 

for ( int i = 0; i < per son.I ength; i ++) { 

p e r s o n [ i ] = ...; //code to create a new Person object 

} 


for (Person p : person) { 

p = null; 

} 


This loop has no effect. 


Although we cannot change the elements of an array, we can change the 
content of an object if the element is a reference to an object. For example, the 
following for-each loop will reset the names of all objects to Java: 


Person]] person = new Person] 100]; 

for ( i nt i = 0; i < per son.I ength; i ++) { 

person[i] = ...; //code to create a new Person object 

} 


for (Person p : person) { 
p. s e t N a me ( " J a v a" ) ; 

} 


This loop is effective. The 
name of every Person 
object is set to Java. 


Notice that we are not changing the elements (references to objects) themselves, 
but the content of the objects referenced by these elements. Thus, the code is 
effective. 

The second restriction is that we cannot access more than one array using a 
single for-each loop. Suppose we havetwo integer arrays numi and num2 of length 
200 and want to create a third array num3 whose elements are sum of the corre¬ 
sponding elements in numi and num2. H ere's the standard for loop: 

i nt [ ] numi = new i nt [ 2 0 0 ] ; 

int[] num2 = new i nt [ 2 0 0 ] ; 

int[] num3 = new i nt [ 2 0 0 ] ; 

II code to assign values to the elements of numi and num2 

/ / c omput e the s urns 

for ( i nt i = 0; i < num3. length; i ++) { 
n u m3 [ i ] = n u ml [ i ] + n u m2 [ i ]; 

} 
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Such a loop cannot be written with a for-each loop. 



The third restriction is that we must access all elements in an array from the 
first to the last element. We cannot, for example, access only the first half or the last 
half of the array. We cannot access elements in reverse order either. 



The for-each loop iterates over every element of an array from the first to the last 
element. We cannot use the for-each loop to access only a portion of an array orto 
access the elements in reverse order. 


This restriction complicates the matter when we try to access elements in an 
array of objects. Consider the following code: 

Person!] person = new Person[100]; 

for ( i nt i = 0; i <50; i ++) { 

p e r s o n [i] = ...; //code to create a new Person object 

} 

for (Person p : person) 

System, out, pri ntl n ( 
p, g e t N a me () ) ; 

} 

This code will crash when the variable p is set to the 51st element (i.e„ an element 
at index position 50), because the element is null. Notice that only the first 50 ele¬ 
ments actually point to Person objects. The elements in the second half of the array 
are all null. 


This loop will result in a 

NullPointerException error. 
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1. Rewrite the following for loop by using a for-each loop. 

for ( i nt i = 0; i < number. I ength; i ++) { 

System, out. pri ntl n ( n u mb e r [ i ]); 

} 

2. Rewrite the following for loop by using the standard for loop. 

for (Person p : person) { 

System, out. pri ntl n(p.getName()); 

} 

3. Why can't the following for loop be expressed as a for-each loop? 

for ( i nt i = 0; i < number. I ength; i ++) { 

number [ i ] = number [ i ] + 50; 

} 


10.4 Passing Arrays to Methods 

We discussed the passing of an object to a method by using string objects as illus¬ 
trations in Chapter 4. Since both an array and an object are a reference data type, the 
rules for passing an object to a method and returning an object from the method 
apply to arrays also. H owever, there are some additional rules we need to remember 
in passing an array to a method and returning itfrom a method. We will cover these 
topics in this section. 

L et's define a method that returns the i ndex of the smal Iest element i n an array 
of real numbers. The array to search for the smallest element is passed to the 
method. Here's the method: 

public int search Mini mu m( double!] number) { 

i nt i ndexOf Mi ni mum = 0; 

for (int i = 1; i < number. I engt h; i ++) { 

if ( n u mb e r [ i ] < number[i ndexOfMi ni mum]) { //found a 
i n de xOf Mi n i mu m = i ; / / s ma I I e r e I e me nt 

} 

} 

return i nd ex Of Mi n i mu m; 

} 

Notice that we use the square brackets to designate that number is an array. The 
square brackets may also be attached to the parameter, as in 

public int search Mini mu m( double number!]) 
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To call this method (from a method of the same class), we write something 
like this: 


double!] array One, arrayTwo; 

II create and assign values to arrayOne and arrayTwo 

II get the index of the smallest element of arrayOne 
i nt mi nOne = searchMi ni mum( arrayOne ); 

II get the index of the smallest element of arrayTwo 
i nt minTwo = searchMi ni mum( arrayTwo ); 

//output the result 

System, out. print! "Mi ni mu m value in Array One is “); 

Sy s t e m. o u t, p r i n t ( a r r a y On e [ mi nOne ] +" at position " 

+ mi nOne ); 


System, out. pri nt("\n\n"); 

System, out. print! 11 Mini mu m value in Array Two is "); 

System, out. pri nt(arrayT wo [minTwo] + " at position " 

+ mi n Two ) ; 

J ust like other objects, an array is a reference data type, so we are passing the 
reference to an array, not the whole array, when wecall thesearchMinimum method. 
For example, when the method is called with arrayOne as its argument, the states of 
memory illustrated in Figures 10.9 and 10.10 will result. There are two references 
to the same array. The method does not create a separate copy of the array. 


bings to Remember 



When an array is passed to a method, only its reference is passed. A copy of the array 
is not created in the method. 


Now let's try another example in which we return an array (actually the refer¬ 
ence to the array) from a method. Suppose we want to define a method that inputs 
double values and returns the values as an array of double. We can define the 
method as follows: 

public double!] read Doubles!) { 
double!] number; 

System, out, print! "How many input values? 11 ); 
int N = scanner, nextl nt(); 
number = new doubl e[N]; 
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1 


minOne 



execution flow 


searchMinimum(arrayOne) ; 


publ i C i nt searchMinimum( doubl e[ ] 


number) 


{ 


at(T) before calling 


searchMinimum 



} 


Local variables do not exist 
before the method execution. 


2 


minOne 


searchMinimum(arrayOne) ; 



publ i c 


i nt 


© 

searchMinimum( doubl e[ ] number) 


{ 


at (T) after the parameter is assigned 



> 


Memory space for the parameter of searchM inimum 
is allocated, and the value of arrayO ne, which is a 
reference (address) to an array, is copied - -> to 
number. So now both variables refer to the same 
array. 


Figure 1 0.9 Passing an array to a method means we are passing a reference to an array. We are not passing 
the whole array. 


} 


for ( i nt i =0; i < N; i + + ) { 

System, out. pri nt("Number " + i + " 
n u mb e r [ i ] = scanner.nextDoubl e(); 

} 

return number; 


The square brackets beside the method return type double indicate that the 
method returns an array of double. Because an array is a reference data type, when 
we say "returns an array of double," we are really saying "returns the reference to 
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3 


minOne = searchMinimum(arrayOne) 


at (T) before return 




searchMinimum( doubl e[ ] 


After the sequence of activities, 
before returning from the method. 


number) 


{ 


4 


minOne = searchMinimum(arrayOne) 


at ( 4 ) after searchMinimum 




public i nt searchMinimumf doubl e[ ] number) { 


Memory space for searchM ini mum is deallocated upon 
exiting the method. The array itself is not part of 
memory allocated for searchM ini mum and will not be 
deallocated upon exit. 


N ote: T he searchMinimum method did not make any 
changes to the contents of the array. H owever, if it did, 
then the changes made to the array contents will remain 

in effect because the array is not deal located. 

x___ 


Figure 10.10 Continuation of Figure 10.9. 


an array of double." Wewill use the shorter expression in general and usethelonger 
expression only when we need to be precise. 

The readDoubles method is called in this manner: 


doubl e[ ] 

a r 

ray One, arrayTwo; 

II assi gn 

va 

lues to arrayOne and 

arrayOne 

= 

r eadDoubl es(); 

a r r a y T wo 

= 

r eadDoubl es (); 


www.it-ebooks.info 











































586 Chapter 10 Arrays and Collections 


Since a new array is created by the method, we do not have to create an array from 
the calling side. In other words, we don't have to do this: 


double!] array One, a r r a y T wo; 

arrayOne = new doubl e[ 30] ; II this is NOT necessary 
a r r ay One = r ead Do ubI es ( ) ; 

It won't cause an error if we create an array from the calling side, but we are doing 
a very wasteful operation. First, it takes up extra memory space. Second, it slows 
down the whole operation because the computer must garbage-collect the extra 
memory space that is not being used. 

Let's try an alternative approach. This time, instead of creating an array inside 
the method and returning the array, the calling side creates an array and passes this 
array to the method: 

int[] my I n t A r r a y = new i n t [ 5 0 ]; 
readl ntegers(myl ntArray); 

The method readintegers fills the passed array with integers. The method is defined 
as follows: 

public void readl ntegersfi nt[] number) { 
for ( i nt i = 0; i < number. I ength; i ++) { 

System, out. pri nt("Number " + i + " : " ) ; 
n u mb e r [ i ] = scanner.nextDoubl e(); 

} 

} 

Notice the return type of readintegers is void because we are not returning an array. 
The method modifies the array that is passed to it. 

Be careful not to mix the two alternative approaches. The following method 
will not work: 

public void bad Method) double!] number ) { 

System, out. print! “How many input values? "); 
int N = scanner. nextlntl); 
number = new doubl e [ N ] ; 

for (int i = 0; i | N; i + + ) { 

System, out. pri nt("Number " + i + " : " ) ; 
n u mb e r [ i ] = scanner.nextDoubl e(); 

} 

} 
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i 


© 

badMethod(arrayOne) ; 


Execution flow 


public void badMethod( doubl e[ ] number) { 
number = new doubl e[ n] ; 


at M j before calling searchMinimum 



} 


Local variables do not exist 
before the method execution. 


2 


badMethodl arrayOne) ; 

at (T) after the parameter is assigned 


Memory space for the parameter of badM ethod 
is allocated, and the value of arrayOne, which is a 
reference (address) to an array, is copied - -> to 
number. So now both variables refer to the same 
array. 



© 


public void badMethod( doubl e[ ] number) { 
number = new doubl e[ n] ; 

} 


Figure 10.11 Effect of creating a local array and not returning it. 

Code such as 

double!] arrayOne = new d o u b I e [ 3 0 ] ; 
bad Method! arrayOne ); 

will leave arrayOne unchanged. Figures 10.11 and 10.12 show the effect of creating 
a local array in badMethod and not returning it. (Note: The return type of bad- 
Method is void.) 

output from the following code? 

st = {10, 20, 30, 40 }; 

(list); 

ut. pr i nt I n( I i st [ 1] ) ; 


Quick 

CHECK 


1. W hat will be an 

i nt [] I i 
my Met hod 
System, o 
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3 


badMethod(arrayOne) ; 



public void badMethod( doubl e[ ] number) { 
number = new doubl e[N] ; 

} 




4 



at (T) after badMethod 



public void badMethod( doubl e[ ) number) { 
number = new doubl e[ ] , 

} 


Memory space for badM ethod is deallocated 
upon exiting the method. The array created 
by this method now has no variable referring 
to it, so this array is deallocated also. 


Figure 10.12 Continuation of Figure 10.11. 

System, out.pri ntl n(l ist[3]); 

public void myMethod(int[] intArray) { 

for ( i nt i = 0; i < i ntArray.I ength; i +=2) { 
i nt Ar r a y [i] = i; 

} 

} 

2. If we replace myMethod of question 1 with thefollowing, what will bean output? 

public void myMethod(int[] intArray) 

{ 

i nt [ ] local = intArray; 

for ( i nt i = 0; i < I ocal.I ength; i +=2) { 

Iocal [ i ] = i; 

} 

} 
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10.5 Two-Dimensional Arrays 

A table organized in rows and columns is a very effective means for communicat¬ 
ing many different types of information. Figure 10.13 shows sample data displayed 
two- in a tabular format. In Java, we represent tables as two-dimensional arrays. The 

dimensional arrays we have discussed so far are one-dimensional arrays because they have only 
oneindex. In this section, wedescribehow two-dimensional arrays are used in Java. 

Let's begin with an example. Consider the following table with four rows and 
five col umns. T he tabl e contai ns the hourly rate of programmers based on thei r ski 11 
level. The rows (horizontal) represent the grade levels, and the columns (vertical) 


Distance Table (in miles) 



Los 

Angeles 

San 

Francisco 

San Jose 

San Diego 

M onterey 

Los Angeles 

- 

600 

500 

150 

450 

San Francisco 

600 

- 

100 

750 

150 

San Jose 

500 

100 

- 

650 

50 

San Diego 

150 

750 

650 

- 

600 

M onterey 

450 

150 

50 

600 

- 


Multiplication Table 



1 

2 

3 

4 

5 

6 

7 

8 

9 

1 

1 

2 

3 

4 

5 

6 

7 

8 

9 

2 

2 

4 

6 

8 

10 

12 

14 

16 

18 

3 

3 

6 

9 

12 

15 

18 

21 

24 

27 

4 

4 

8 

12 

16 

20 

24 

28 

32 

36 

5 

5 

10 

15 

20 

25 

30 

35 

40 

45 

6 

6 

12 

18 

24 

30 

36 

42 

48 

54 

7 

7 

14 

21 

28 

35 

42 

49 

56 

63 

8 

8 

16 

24 

32 

40 

48 

56 

64 

72 

9 

9 

18 

27 

36 

45 

54 

63 

72 

81 


Tuition Table 



Day 

Students 

Boarding 

Students 

Grades 1-6 

$16,000.00 

$28,000.00 

Grades 7-8 

$19,000.00 

$31,000.00 

Grades 9-12 

$22,500.00 

$34,500.00 


Figure 10.13 Examples of information represented as tables. 
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represent the steps within a grade level. Reading the table, we know a programmer 
with skill grade level 2, step 1 earns $36.50 per hour. 




0 

1 

Step 

2 

3 

4 


0 

10.50 

12.00 

14.50 

16.75 

18.00 

Q) 

~o 

i 

20.50 

22.25 

24.00 

26.25 

28.00 

o 

2 

34.00 

36.50 

38.00 

40.35 

43.00 


3 

50.00 

60.00 

70.00 

80.00 

99.99 


We declare the pay scale table as 
doubl e[ ][] payScal eTabI e; 
or 

doubl e payScal eTabl e[][] ; 

and create the array as 

payScal eTable = new doubl e[ 4] [ 5] ; 

The payScaleTable array is a two-dimensional array because two indices— 
one for the row and another for the column— are used to refer to an array element. 
For example, to refer to the element at the second column (column 1) of the third 
row (row 2), we say 

payScal eTabl e [ 2 ][ 1 ] 

Figure 10.14 illustrates how the two indices are used to access an array element of 
a two-dimensional array. 

Row # Column # 

J I 

payScaleTable[ 2 ] [ 1 ] 

/ 

12 3 4 


36.50 


Figure 10.14 Accessing an element of a two-dimensional array. 
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Let's go over some examples to see how the elements of two-dimensional 
arrays are manipulated. This code finds the average pay of the grade 2 programmers. 

double average, sum = 0.0; 

for ( i nt j = 0; j < 5; j ++) { 
sum += payScal eTabl e[2][j ]; 

} 

average = sum / 5; 

The next example prints out the pay difference between the lowest and highest 
steps for each grade level. 


double difference; 


for ( i nt i = 0; i < 4; i ++) { 

difference = payScal eTabl e[i][4] - payScal eTabl e[i][0]; 
System, out. printing Pay difference at Grade Level " + 
i + " is " + difference); 


} 


This code adds $1.50 to every skill level. 


for ( i nt i =0; i <4; i + + ) { 

for ( i nt j =0; j <5; j + + ) { 
payScal eTabl e[i][j ] += 1.50; 

} 

} 

In the previous examples, we used literal constants such as 5 and 4 to keep them 
simple. For real programs, we need to writea loop that will workfortwo-dimensional 
arrays of any size, not just with the one with four rows and five columns. We can use 
the length field of an array to write such a loop. Using the length field, we can 
rewrite the third example as 

for ( i nt i = 0; i < payScal eTabl e.Iength; i ++) { 

for ( i nt j = 0; j < payScal eTabl e[i]. I ength; j ++) { 
payScal eTabl e[ i ][j ] += 1. 50; 

} 

} 

Do you notice a subtle difference in the code? Let's examine the difference 
between the expressions 


payScal eTabl e.I ength 


and 


payScal eTabl e[i]. I ength 
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First, there is actually no explicit structure called two-dimensional array in Java. 
We only have one-dimensional arrays in Java. However, we can have an array of 
arrays, and this is how the conceptual two-dimensional array is implemented in 
Java. The sample array creation 

payScal eTable = new doubl e[ 4] [ 5] ; 

is really a shorthand for 

payScal eTable = new doubl e [ 4 ] [ ]; 

payScal eTabl e[0] = new double [ 5 ] ; 
payScal eTabl e[l] = new doubIe [ 5 ] ; 
payScal eTabl e[2] = new doubIe [ 5 ] ; 
payScal eTabl e[3] = new doubIe [ 5 ] ; 

which is equivalent to 

payScal eTable = new doubl e [ 4 ][ ]; 

for ( i nt i =0; I <4; i + + ) { 

payScal eTabl e[ i ] = new doubl e [ 5 ] ; 

} 

Figure 10.15 shows the effect of executing the five statements. The expression 

payScal eTabl e.I ength 

refers to the length of the payScaleTable array itself. 


payScaleTable 



And the expression 

payScal eTabl e [ 1 ]. Iength 

refers to the length of an array stored at row i of payScaleTable. 


payScaleTable 



www.it-ebooks.info 




















10.5 Two-Dimensional Arrays 593 


Executing... 


Will result in... 


payScaleTable 


0 

1 

payScaleTable = new doubl e[ 4 ] [ ]; 2 

3 





Figure 10.15 Executing the statements on the left in sequence will create the array of arrays shown on 
the right. 
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We call an array that is part of another a subarray. The payScaleTable has four 
subarrays of the same length. Since we allocate the subarrays individually, we can 
create subarrays of different lengths. The following code creates a triangular array 
whose subarray triangularArray[i] has length i. 

tri angul arArray = new doubI e [ 4 ][ ]; 

for ( i nt i =0; i <4; i + + ) 

tri angul arArray[i ] = new doubl e[ i +1] ; 

The resulting triangularArray looks like this: 


triangularArray o 



An array of arrays can be initialized at the time of declaration. The following 
declaration initializes the payScaleTable array: 

doubl e[ ] [ ] payScal eTabl e 


II 

> * 1 

« * 1 

1— 1 

o 

50, 

i—* 

NJ 

00, 

14. 

50, 

16. 

—1 

«_n 

18. 

00}, 

{20. 

50, 

22. 

25, 

24. 

00, 

26. 

25, 

28. 

00}, 

{34, 

00, 

36. 

50, 

38. 

00, 

40. 

35, 

43, 

00}, 

{50. 

00, 

60. 

00, 

70. 

00, 

80. 

00, 

99, 

99} } 


Here's the complete sample program: 



Chapter 10 Sample Program: Sample program for processing 

2 - D array of double. 


File: ChlOPayScal eTabl e.java 

*1 

class ChlOPayScal eTabl e { 

public static void main (String!] args) { 

doubl e[ ] [ ] payScal eTabl e 


{10. 

50, 

12. 

00, 

14. 

50, 

16. 

—1 

«_n 

18. 

00} 

{20. 

50, 

22. 

25, 

24, 

00, 

26. 

25, 

28. 

00} 

{34. 

00, 

36. 

50, 

38, 

00, 

40. 

35, 

43. 

00} 

{50. 

00, 

60. 

00, 

70, 

00, 

80. 

00, 

99. 

99} 


www.it-ebooks.info 



















10.5 Two-Dimensional Arrays 595 


} 


II Find the average pay of level 2 employees 
double sum = 0.0, average; 

for ( i nt j =0; j <5; j + + ) { 
sum += payScal eTabl e[2][j ]; 

} 

average = sum / 5; 

System, out. pri ntl n(" Average of Level 2 Employees: " + average ); 
System, out. pri ntl n("\n"); 

//Display the pay difference at each grade level 

doubl e difference; 


for 


} 


( i nt i = 0; i < 4; i + + ) { 

difference = payScal eTabl e[i][4] - paySca I e T abI e [ i ][ 0 ]; 
System, out. pri ntl n("Pay difference at Grade Level 11 + 

i + " is " + difference); 


//Print out the pay scale table 
System, out. pri ntl n ( " \ n" ) ; 


for ( int i = 0; i < payScal eTabl e.I ength; i ++) { 


for ( int j = 0; j < payScal eTabl e[i]. I ength; j ++) { 


System, out. print) payScal eTabl e[i][j ] + 

} 

System, out. pri ntl n(""); 

} 

//Increase the pay by 1.50 for every level/step 
II and display the resulting table 
System, out. pri ntl n("\n"); 


for ( int i = 0; i < payScal eTabl e.I ength; i ++) { 

for ( int j = 0; j < payScal eTabl e[i]. I ength; j ++) { 
payScal eTabl e[i ][j ] +=1.50; 

S y s t e m. o u t. p r i n t ( p a y S c a I e T a b I e [ i ] [ j ] + " " ); 

} 

System, out. pri ntl n ( ""); 


www.it-ebooks.info 



596 Chapter 10 Arrays and Collections 


We can nest for-each loops to process a two-dimensional array. Remember 
that the two-dimensional array is structurally an array of arrays (as illustrated in 
Figure 10.15), and the nested for-each loops will make this fact explict. To printout 
the pay scale table, for example, we write 

for (double!] row : payScal eTabl e) { 
for (double pay : row) { 

S y s t e m. o u t. p r i n t ( p a y + " " ) ; 

} 

System, out. pri ntl n(""); 

} 

Theouter loop iterates over therows in the payScaleTable two-dimensional array. Each 
row is one-dimensional array of double, so the type is declared as double!]. A nd the 
inner loop iterates over the elements in each row. Notice that we cannot rewrite the 
other loop statements in the ChiOPayScaleTable program by using the for-each loop. 

There is no limit to the number of dimensions an array can have. We can 
declare three-dimensional, four-dimensional, and higher-dimensional arrays. How¬ 
ever, arrays with a dimension higher than 2 are not frequently used in object- 
oriented languages. For example, data that were represented as a three-dimensional 
array in a non-object-oriented language can be represented more naturally as a one¬ 
dimensional array of objects with each object containing an array or some other 
form of data structure (see Exercise 12 on page 615). 


P 


Quick 


CHTCK 


1. Write a codefragment to compute the average pay of the pays stored in the 
payScaleTable array. 

2. Write a code fragment that finds the largest integer in this two-dimensional array. 

i nt [ ] [ ] table = new i nt [ 10] [ 10] ; 

3. What is an output from this code? 

i nt [ ] [ ] table = new i nt [ 10] [ 5] ; 

System, out. pri ntl n ( t a b I e. I ength) ; 

System, out. pri ntl n ( t a bI e [ 4 ].I ength); 


array overflow 


10.6 


Lists and Maps 


Once an array is created, its capacity cannot be changed. For example, if we create 
an array of 20 elements, then we are limited to store at most 20 elements in using 
this array. If we need to add elements, then we have to create a new array. [Note: We 
will learn how to do this in Section 10.7.) We call the condition in which an array 
does not have any unused position left to add another element an array overflow. 
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java.util 

JCF 

interface 

abstract 

method 


Whenever we use arrays in an application, we need to consider the possibility 
of an array overflow. We can usually avoid an array overflow by declaring its capac¬ 
ity to be a large number. However, if we declare the capacity of an array too large, 
we may avoid an array overflow but end up underutilizing the space (e.g., using only 
20 positions in an array with the capacity of 500). If we do not want our application 
to be limited to some fixed capacity, we need to write code that handles an array 
overflow by allocating a larger array. 

If we need to handle an array overflow for multiple arrays we use in an appli¬ 
cation, wecan defi ne a class that handles the array overflow so wedon'thaveto im¬ 
plement an overflow-handling code for individual arrays. We might call the new 
class ExpandableArray. By using this class, wecan keep adding new elements with¬ 
out worrying about the overflow condition, because the class handles the overflow 
condition automatically. 

I tturns out there's no need for us to write such an ExpandableArray class because 
thej ava standard library ava. util already includes various cl asses and (interfaces) for 
maintaining a collection of objects. They are collectively referred as the Java Collec¬ 
tion Framework, or JCF. Wewill study the basic ones in this section. 

T he fi rst i s the List i nterface. L i ke a cl ass, an interface i s a reference data type; 
but unlike a class, an interface includes only constants and abstract methods. An 
abstract method has only the method header (or, more formally, the method proto¬ 
type)', that is, it has no method body. The abstract methods of an interface define a 
behavior. For example, the List interface includes 25 abstract methods that collec¬ 
tively define a behavior of a linear list, such as adding an element, removing an 
element, and so forth. 

We cannot create an instance of a Java interface. (Wore: To differentiate a user 
i nterface from a reference data type i nterface, wewill use the term Java interface to 
refer to the latter.) For example, the following will result in a compile-time error: 


List my List = new List ( ); 


To create an i nstance that wi 11 support a List behavi or, we need a cl ass that i m- 
plements the List interface. We say a class implements an interface if it provides the 
method body to all the abstract methods defined in theJ ava interface. 

There are two classes in JCF that implement the List interface: ArrayList and 
LinkedList. Because they implement the same interface, they behave exactly the 
same. That is, there's no difference in using them (as long as we use the methods 
defined in the List interface). They differ in the internal data structure they use to 
implement the interface. The ArrayList class uses an array, and the LinkedList class 
uses a technique called linked-node representation. We choose one over the other 
depending on the nature of application (e.g., choose LinkedList if the application 
requires frequent insertions and deletions of elements but occasional searching for 
elements in the list). It is beyond our scope to provide an in-depth comparative 
analysis here. In most situations, the ArrayList class would be preferable so we will 
use it for the examples in this chapter. 
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There is another "expandable array" in the JCF called Vector. The Vector class pre¬ 
dates the JCF classes, but from Java 2 SDK 1.2, the class was modified to implement 
the List interface. Because it was designed before the JCF classes, it includes many 
methods in addition to the List methods. In general, the ArrayList class is recom¬ 
mended for most situations. 


Let's study how we can use the methods of the List interface. First we need to 
declare and create an instance of a class that implements the List interface. Let's use 
the ArrayList class. From what we have learned so far about declaring and creating 
an instance of a class, we would write something like 

ArrayList my List; 

. . . Not recommended 

my List = new ArrayList)); 

if the class is ArrayList. This would work (you'll get only a compiler warning), but it 
is not a recommended style of programming. There are two improvements we 
should make. The first is to declare the variable as the Java interface and to assign an 
i nstance of the cl ass that i mpl ements the i nterface. A ppl y i ng thi s i mprovement will 
result in 


List my Li St; - myList is declared as 

type List 

my List = new ArrayList!); 

Basically this style of declaration improves the ease of program modification. 
Suppose, for example, there are many methods that accept an ArrayList object 

public void myMet hod( Ar rayLi st aList) 

With this declaration, we can only pass an instance of ArrayList. Now suppose at a 
later time we decide to use LinkedList to improve performances for certain types of 
operations. We have to go back and make changes to all those method headers. But 
what if we declare the method from the beginning as follows? 

public void myMet hod( Li st aList) 

Since we can pass an instance of either ArrayList or LinkedList (or an instance of any 
class that implements the List interface), no changes are required. We will study the 
J ava interface in greater detail in Chapter 13. 

The second improvement is specific to Java 5.0 and later JCF classes. If we 
declare a list object as 

List my List = new ArrayList)); 

there are no restrictions on the type of objects we can add to the list. For example, we 
can add String objects, Person objects, Vehicle objects, and SO forth to this myList. 
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heterogeneous 

list 

homogeneous 

list 


add 


We call such list a heterogeneous list. In most applications, there is no need to 
maintain such heterogeneous lists. What we need is a homogeneous list, where the 
elements are restricted to a specific type such as a list of Person objects, a list of 
string objects, a list of Book objects, and so forth. Specifying the element type im¬ 
proves the program reliability because an error such as trying to add a wrong typeof 
object to a list can be caught during the compile time. It is strongly recommended to 
use homogeneous lists. 

To specify a homogeneous list, we must include the type of elements in the 
declaration and creation statements. Here's an example that declares and creates a 
list Of Person objects: 

Li st<Person> friends: 

friends = new ArrayLi st<Person>( ); 

The general syntax for the declaration is 

interface-or-class-name < element-type > identifier, 

A nd the general syntax for the creation is 

identifier = new class-name < element-type > ( parameters ) ; 

We can combine the two into a single statement as 

interface-or-class-name < element-type > identifier 

= new class-name <element-type> ( parameters ) ; 


for example, 

List<Person> friends = new ArrayLi st<Person>{ ); 

N ow we are ready to study the basic operations of the List interface. 0 nee a list 
is created properly, weean start adding elements. I n the following example, weere- 
atea list named friends and add four Person objects to the list: 

List<Person> friends = new ArrayLi st<Person>{ ); 

Person person; 

person = new Person! "Jane", 10, 1 F 1 ) ; 
friends.add(person); 

person = new Person! "Jack", 16, 1 M 1 ); 
friends.add(person); 

person = new Person! "Jill", 8, 1 F 1 ) ; 
friends.add(person); 

person = new Person! "John", 12, 1 M 1 ); 
friends.add(person); 
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size 


get 


traversal 


iterator 


To find out the number of elements in a list, we use its size method. The 
following code will print out3: 

List<String> sample = new ArrayLi st<Stri ng>{ ); 

sampl e. add("One java"); 

sampl e. add("One java"); 

sampl e.add(" One Java"); 

System, out. pri ntl n ( s a mp I e. si z e ( )) ; 

We can access objects in a list by giving their index position in the list, much 
as we did with the array. We use the ge method to access an object at index posi¬ 
tion i. For example, to access the Person object at position 3 [note: the first element 
is at position 0) in the friends list, we write 

Person p = friends, ge t ( 3 ); 

An invalid argument, such as a negative value or a value greater than sizeO- 1, will 
result in an indexOutofBoundsException error. 

0 ne of the most common operations we perform on a list is traversal. This op¬ 
eration, also called scanning or iteration, accesses all elements in a list. To traverse 
a listfrom the first to the last element, wecan usethefor-each loop. Here's how we 
can print out the names of all those in the friends list by using the for-each loop: 

for (Person p : friends) { 

System, out. pri ntl n(p.getName()); 

} 

This for-each loop is actually a shortcutfor using an iterator pattern. When we 
call the iterator method of a list, it returns an iterator object (an instance of a class 
that implements the iterator interface) that supports the two methods hasNext and 
next. Here’s the code to print out the names of all those in the friends list by using 
an iterator: 

Person p; 

Iterator <Pe rson > itr = fr i ends. i terator () ; 

while (itr.hasNext()) { 
p = it r. next () ; 

System, out. pri ntl n(p.getName()); 

} 

Again, the for-each loop is built on top of the iterator pattern as a syntactical 
shortcut, and wherever the iterator pattern is available, wecan (and should) use the 
cleaner and less error-prone for-each loop. 
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The traversal operation is necessary to search a list for elements that meet 
some criterion. Let's say we want to print out the names of those in the friends list 
who are older than 10. Here's the code: 

for (Person p : friends) { 

if ( p,a g e ( ) >10) { 

System, out. pri ntl n(p.getName()); 

} 

} 

Instead of simply printing out their names, we could create another list to keep track 
of those who are older than 10: 

List<Person> ol derThanlOLi st = new ArrayLi st <Person>( ) ; 

for (Person p : friends) { 

if ( p.age () >10) { 

ol derThanlOLi st.add(p); 

} 

} 

The original friends list remains unchanged; that is, no objects are removed from 
the list. We simply have a second list that points to a subset of elements in the 
friends list. The situation can be illustrated as follows (two Person objects are older 
than 10): 


friends 



To remove an element from a list, we use the remove method. There are two 
versions: one specifies the index position of the object to remove, and the other spec¬ 
ifies the object itself (i.e., the reference to this object). If we use the first version, 
here's how we remove the Person object at index position 2 in the friends list: 

fri ends, r e mo v e ( 2 ); 

The second version of the remove method requires a reference to an object. 
One way to acquire a reference to an object we want to remove is via traversal. 
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H ere's the code that traverses the friends I i st and removes al I Person obj ects who are 
older than 10: 

List<Person> temp List = new ArrayLi st <Person>( ) ; 

//first we collect those we want to remove from the 
//friends list in a separate list 
for (Person p : friends) { 

if ( p. age () >10) { 
tempLi st. add( p) ; 

} 


II then we remove every element in temp List 
//from the friends list 
for (Person p : tempList) { 

friends.add(p); 

} 

Some of you might have thought about the following code: 

for (Person p : friends) { 

if ( p. a g e () >10) { 
friends.re mo ve(p); 

0.. O 


This is an invalid operation. We are not allowed to modify the list we are traversing. 
Thefor-each loop (and the underlying iterator pattern) is a read-only traversal. 



Lists and Primitive Data Types 

With an array, we can store either primitive data values (int, double, etc.) or ob¬ 
jects. With a list, we can store only objects. If we need to store primitive data values 
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in a list, then we must use wrapper classes such as integer, Float, and Double. To 
specify a homogeneous list of integers, we have to do something like this: 

List<lnteger> intList = new ArrayLi st<l nteger>( ); 

i ntLi st. add(new I nt eger ( 15) ); 
i nt Li st. add ( new I nt eger ( 30) ); 


W hen we access the elements of intList, which are integer objects, we need to 
use the intvalue method to get the integer value. The following code computes the 
sum of integer values stored in intList: 

i nt s j m = 0; 

for (Integer i nt Obj : intList) { 
sum = sum + intObj.intValue(); 

} 

Instead of this tedious way of dealing with primitive data values, we can use 
automatic boxing and unboxing features (introduced in Java 5.0). We can write the 
code as if we could store primitive data values in lists. For example, the following 
code is valid: 

List<lnteger> intList = new ArrayLi st<l nteger>( ); 

i ntLi st. a d d ( 15) ; 

i ntLi st. a d d ( 3 0) ; 

i nt sum = 0; 

for ( i nt value : intList) { 
sum = sum + value; 

} 

Keep in mind that there are no structural changes. We are still adding integer 
objects to intList (see the declaration for intList). It is just a syntactical shortcut. 
When we write, for example, 

i ntLi st. a d d ( 3 0) ; 
the compiler translates it to 

i nt Li st. add ( new I nt eger ( 30) ); 

This is called auto boxing. And when we write 

int num = intList. get ( 1) ; 
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the compiler translates it to 

int num = i ntLi st.get(l). i ntVal ue( ); 

This is Called auto unboxing. 

Let's conclude our discussion of the List interface with the BookTracker helper 
class we used in the Sample Development section of Chapter 7. The BookTracker 
class uses an ArrayList to keep track of library books. Here's the definition: 


/ * * 

Chapter 7 Sample Development: Library Overdue Checker 
File: BookTracker.java 

*1 

import java,util.*; 

class BookTracker { 

public static final int ERROR = -1; 

private L i st <L I braryBook > books; 

public BookTracker) ) { 

books = new Li nkedLi st <Li braryBook >() ; 

} 


public void add ( L i brar y Book book) { 
books.add ( book) ; 

} 

public double get Char ge( ) { 

return get Cha r ge( new Greg o ri anCa I e nda r ( )) ; //set today as due date 

} 



public double getCharge ( Gregori anCaI endar returnDate) 

if ( b o o k s. i s E mp t y () ) { 
return ERROR; 

} else { 

return total Charge(returnDate); 

} 

} 



getList 


public String getList) ) { 

Stri ngBuffer result = new Stri ngBuffer)""); 

String lineSeparator = System. getProperty)" line. separator"); 

for (LibraryBook book: books) { 

resul t, append) book.toStri ng( ) + lineSeparator); 

} 
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return result. toStringl); 

} 

private double tota I Charge ( Gregori anCaI endar returnDate) { 

f -|- 

double totalCharge = 0.0; totaicharge 

for (Li braryBook book: books) { 

totalCharge += book. computeCharge( ret urnDate) ; 

} 

return totalCharge; 

} 

} 


Map 

Let's move on to another useful interface cal led Map. There are two classes that im¬ 
plement this interface: HashMap and TreeMap. We will describe the TreeMap class 
in this section because this is the class we used in implementing the helper WordList 
class in Chapter 9. The TreeMap class actually implements a subinterface of Map 
called SortedMap, where the entries in the map are sorted. 

A map consists of entries, with each entry divided into two parts: key and 
value. No duplicate keys are allowed in the map. Both key and value can be an in¬ 
stance of any class. The main advantage of a map is its performance in locating an 
entry, given the key. Consider, for example, that we want to maintain a table of 
course evaluations. For each course offered on campus, we want to keep an evalua¬ 
tion that is summarized from the student opinion poll collected at the end of the 
term. The course number (e.g., CS0101) is the key, and the evaluation is the value. 
We would want to store the information as a map because we need to look up the 
evaluation of a course efficiently, as there are hundreds or thousands of courses. The 
search would take too long if we used other data structures. 


As we know, a Java array allows only integer indices. In some situations we may 

H want to use an array with indices other than integers. For example, a WordList 
from Chapter 9 can be viewed as an array of numbers with words (String) as its 
indices. A map can be characterized as an expandable array with nonintegers 
(i.e., instances of any class) as its indices. So whenever we need an array of values 
with noninteger indices, a map is a possible solution. 


When declaring and creating a map, we must specify the type for the key and 
the value. For example, to declare and create a map with string as both its key and 
value, we write 

Map<Stri ng,Stri ng> table; 

table = new TreeMap<Stri ng, Stri ng>( ); 
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clear 
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contains key 


entrySet 
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We use its put method to add the key-value pairs to the map as 

table, p u t ( “C S 0101" , “Great course. Take it"); 

where the first argument is the key and the second argument is the val ue. To remove 
an entry, we use the -emove method with the key of an entry to remove from the 
map, for example, 

t a b I e. r e mo v e ( " C S 2 3 0 0 " ); 

Instead of removing individual elements, we can remove all of them at once 
by calling the clear method. The statement 

t abl e.cI ear ( ); 

removes everything from the map, making it an empty map. 

To retrieve the value associated to a key, we call the map's get method. 

String courseEval = table, g e t ( 11 C S10 2" ); 

We can ask the map if it contains a given key. To check, for example, whether 
the map contains an evaluation for course number CS0455, we write 

boolean result = tabl e. contai nsKey("CS0455"); 

If there's no matching entry, then the value null is returned. 

To traverse a map, we must first call its entrySet method to get a set of ele¬ 
ments. The method returns an instance of a class that implements the Set interface, 
another interface in JCF, that models a mathematical set. Those interested in using 
the Set interface are referred to the J ava A PI documentation. The methods defined 
in the Set interface are very similar to those defined in the List interface. If we 
know how to use the List interface, then it won't take long for us to understand the 
Set interface. 

An element in a map is a key-value pair, so the entrySet method returns a set 
of key-value pairs. A key-value pair is an instance of a class that implements the 
Map.Entry interface. The dot notation indicates that the Entry interface is defined in 
the declaration of the Map interface. Such a nested declaration is useful in avoiding 
a naming conflict. 

Two useful methods defined in the Map.Entry interface are the getKey and 
getvalue, whose purpose is to retrieve the key and the value of an entry, respec¬ 
tively. To put it all together, here's an example that outputs the course numbers and 
their evaluations stored in the table map: 

for ( Map. Entry<Stri ng,Stri ng> entry : tabI e.entrySet ( )) { 
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Notice the type declaration for the loop variable entry is Map.Entry<string, string>. 
Because the key and value component of Map.Entry can be of any class, we need to 
indicate the actual type for the key and the value specific to this entry. 

We are now ready to present the WordList class. It uses a TreeMap object to 
keep track of distinct words in a document and how many times they occur in the 
document. Notice the TreeMap class actually implements a more specialized map 
interface called SortedMap, a subinterface of the Map interface that adds the be¬ 
havior of sorting the elements in ascending key order. This is exactly the data struc¬ 
ture we want to use here because we want to access and display the words and their 
count in alphabetical order. Here's the definition: 


Chapter 9 Sample Development: Word Concordance 
File: WordLlst.java 


import java.util.*; 
class WordList { 

S o r t e d Ma p <S t r i n g, I n t e g e r > table; 
public WordList! ) { 

table = new Tr ee Ma p <S t r i ng, I n t e g e r > () ; 

} 

public void add(Stri ng word) { 
i nt v a I ; 



if (table, contains Key(word)) { 
val = table.get (word) + 1; 


Auto boxing and unboxing 
are used in this method. 


} else { 

//word occurs for the first t i me 
val =1; 

} 


} 


tabl e. put(word, val) 


public String get Concordance! ){ 

String line; 

String I i neTermi nator 

= System. getProperti es(), getPropertyl 
Stri ngBuffer strBuf = new S t ri n g B u f f e r ( ""); 


getConcordance 


Ii n e. separator") 


for (Map. Entry<Stri ng, I nteger> entry : t a bl e. ent r ySet () ) { 
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line = entry.getVal ue(). toStri ng() + " \t" + 
entry, get K e y ( ) + I i neTermi nator; 


strBuf.append(line); 

} 

return st r Buf. t oSt ri ng( ) ; 

} 

public void reset ( ) { 
t a bl e. c I ea r ( ); 

} 


reset 


I 


Compared to the amount of work the class has to perform, the length of its 
source code is rather short. This is so because the hard part of maintaining the data 
structure is done by the TreeMap class. Had we tried to implement the WordList 
class without using the TreeMap class, the source code would have been much 
longer. A little effort to study thej C F classes pays handsomely when the ti me comes 
for us to implement an efficient data manager class, such as the WordList class. 


Quick 

CHECK 


1. What is the output from the following code? 

List<String> list = new ArrayList<String>(); 

f o r ( i nt i = 0; i < 6; i ++) { 

I i st. add("el ement " + i); 

System, out. pri ntl n(li st. size))); 

} 

2. What is the output from the fol lowi ng code? 

List<String> list = new ArrayList<String>(); 

f o r ( i nt i = 0; i < 6; i + + ) { 

I i st. add("el ement " + i); 

} 

I i s t. r e mo v e ( 1 ); 

I i s t. r e mo v e ( 3 ); 

System, out. pri ntl n(li st. get(2)); 

3. Identify all errors in the following code. 

List<String> list = new ArrayLi st<l nteger>(); 
List<Person> people = new L i s t <Pe r s o n >( ) ; 
Map<String> table = new Map(); 
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10.7 Sample Development 


The Address Book 

In this section, we will design a class called an AddressBook to maintain a collection of 
Person objects. The AddressBook class is implemented by using an array. We will use 
the Person class defined in Section 10.2. Through the design of the AddressBook 
class, we will reiterate the key principles of object-oriented design. 

Notice that we are not developing a complete program here. We are designing 
only one of the many classes we need for a complete address book program. For the 
complete program, we need a main class, objects for doing input and output, and so 
forth. In this section, we will concentrate on one class that is only responsible for main¬ 
taining a collection of Person objects. This class will not perform, for example, input and 
output of Person objects, following the single-task object (STO) principle introduced in 
Chapter 4. We will discuss the importance of the STO principle while we develop the 
AddressBook class. One objective we have in designing the AddressBook class is to 
make the class reusable in many different programs. Many of the design decisions we 
will make during the development are based on implementing a reusable class. 

Problem Statement 

Write an AddressBook class that manages a collection of Person objects. An 
AddressBook object will allow the programmer to add, delete, or search for a 
Person object in the address book. 

Overall Plan 

Our first task is to come up with an overall design of the class. Let's begin by first identify¬ 
ing the core operations that an address book object must support. The problem state¬ 
ment indicated three major operations: add, delete, and search. These three operations 
are pretty much a standard in any collection of data values. For any kind of collections,you 
will always want to be able to add a new item, delete an old item, and search for an item 
or items. An address book is no exception as it is a collection of information about people 
for whom you would want to add, delete, and search data. 

Our task here is to design a class that will maintain an address book by supporting 
these three operations. We will define three methods for the class: add,delete, and search. 
Our working design document for the AddressBook class is therefore as follows: 


Design Document: The Public Methods of the AddressBook Class 

Method 

Purpose 

AddressBook 

A constructor to initialize the object. We will include multiple 


constructors as necessary. 

a d d 

Adds a new Person object to the address book. 

del et e 

Deletes a specified Person object from the address book. 

search 

Searches for a specified Person object in the address book 


and returns this person if found. 
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10.7 Sample Development— continued 


develop¬ 
ment steps 


We will implement the class in this order: 

1. Implement the constructor(s). 

2. Implement the add method. 

3. Implement the search method. 

4. Implement the delete method. 

5. Finalize the class. 


This order of development follows a natural sequence. To implement any instance 
method of a class, we need to be able to create a properly initialized object, so we will 
begin the class implementation by defining a constructor. As a part of defining a con¬ 
structor, we will identify necessary data members. We will add more data members as we 
progress through the development steps.The second step is to implement the add rou¬ 
tine, because without being able to add a new Person object, we won't be able to test 
other operations. For the third step, we will implement the search routine. And for the 
fourth step, we will implement the last routine. Although we could implement the delete 
routine before the search routine, we need some form of searching to test the correctness 
of the delete routine. In other words, we delete a person and attempt to search for this 
person, verifying that the search will not find the deleted person. So we will implement 
the search routine before the delete routine. 


Step 1 Development: Skeleton with Constructors 

step 1 In step 1, we will identify the data members and define the constructor(s) to initialize 

design them. The key data member for the class is a structure we will use to keep track of a col¬ 

lection of Person objects. We will use an array for this data structure. Our decision to use 
an array is based on pedagogy. Using a List from JCF will simplify our development effort, 
but it is more important to learn how to use arrays. 

We will create an array of Person objects in the constructor. At the time we create 
an array, we must declare its size. Remember that the size of an array is the maximum 
number of elements this array can hold.The actual number of Person objects stored in 
the array will be anywhere from zero to the size of the array. 

We have two possible alternatives for specifying the size of an array. First, we can 
let the programmer pass the size as an argument to the constructor. Second, we can 
set the size to a default value. Both alternatives are useful. If the programmer has a 
good estimate of the number of Person objects to manage, she can specify the size in 
the constructor. Otherwise, she can use the default size by not specifying the size in 
the constructor. We will define two constructors to support both alternatives. This will 
give programmers flexibility in creating an AddressBook object. 

If we are going to provide a constructor in which the programmer can pass 
the size of an array, then we need to write the constructor so it won't crash when an 
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invalid value is passed as an argument. What would be an invalid argument value? 
Since we are dealing with a collection of objects and the size of a collection cannot 
be negative, an argument value of less than zero is invalid. Also, even though a collec¬ 
tion whose size is zero may make sense in theory, such a collection makes no sense 
in practice. Therefore, we will consider zero also as an invalid argument value. We will 
require an argument to a constructor to be a positive integer. We will throw an 
IMegalArgumentException for an invalid value. 

At this point, we have only one data member—an array of Person objects. We 
will call it entry and set its default size to 25.There is no particular reason for selecting 
this size. We simply picked a number that is not too small or too big. We can change 
this value later if we need to. 

We will define two constructors. The first constructor will call the second con¬ 
structor with the value 25 (default size) as its argument.The second constructor creates 
an array of Person objects of the size passed as its parameter. Inside the second con¬ 
structor, we include a temporary test output statement.The class is defined as follows: 



* * 

* This class is designed to manage an address book 

* Person objects. The user can specify the size of 

* when it is created. If no size is specified, then 

* is set to 25 Person objects. 

* 


that contains 
the address book 
the default size 


* @a u t h o r Dr. Caffeine 

* 


*1 

class AddressBook { 

private static final i nt DEFAULT5IZE = 25; 
private Person!) entry; 

public Addr ess Book) ) { 

t hi s( DEFAULT SIZE ) ; 

} 



public AddressBook(int size) { 


if (size <= 0 ) { //invalid data value, use default 

throw new I I I egal ArgumentExcepti on("Si ze must be positive,"); 

} 

entry = new Person[size); 

System, out. p r i n 11 n ( " array of "+ size + " is created."); II TEMP 

} 

} 
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10.7 Sample Development— continued 


To test this class,we have included a temporary output statement inside the second 
constructor. We will write a test program to verify that we can create an AddressBook 
object correctly. The test data are as follows: 


Step 1 Test Data 

Data Value 

Purpose 

Negative numbers 

Test the invalid data. 

0 

Test the end case of invalid data. 

1 

Test the end case of valid data. 

>= 1 

Test the normal cases. 


We will use a very simple test program: 


Chapter 10 Sample Program: A test main program for 
verifying the step 1 AddressBook class. 

File: TestAddressBook.j ava 

*/ 

import java.util.*; 

class TestAddressBook { //Step 1 Test Main 

public static void main(String a r g s [ ]) { 

AddressBook my Book; 

String i nput St r; 

int size; 

Scanner scanner = new ScannerfSystem. in); 

whiIe (true) { 

System, out. print! “Array size: "); 
inputStr = scanner, n ex t ( ); 

if ( i nputStr.equal si gnoreCase( "stop" )) { 

break; 

} 
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} 

} 


step 2 
design 


alternative 
design 1 

alternative 
design 2 


size = I nteger. parsel nt(i nputStr); 

try { 

my Book = new AddressBook(size); 

} catch ( I I I egal ArgumentExcepti on e) { 

System, out. p r i n 11 n (" Exception Thrown: size = " + size); 

} 

} 


Run the program several times with a different set of test data and verify that we 
get the correct results. 

Step 2 Development: Implement the add Method 

In the second development step, we will implement the add method. We mentioned in 
the overall design step that this class will not do any input or output of person data. 
This decision is based on the STO principle. A single object doing both the input/ 
output routines and maintaining the array will reduce its usability. For example, had the 
AddressBook class handles also the input and output of person data, the use of this 
class would dictate or impose the style of input and output routines on the program¬ 
mers who want to reuse this class.The programmer will not have an option of selecting 
the input and output style appropriate for his or her uses. 

Following the STO principle, we will let the programmer decide how she will 
input and output person data. The task of the add method is to accept a Person ob¬ 
ject as its parameter and add the passed Person object to the array. Since the array is 
limited in size, what should we do if there is no more space to add another Person 
object? There are two alternatives. Alternative , 1 is to return false if a new 

Person object cannot be added to the array, that is, if the array is full.The method will 
return true otherwise. Alternative design 2 is to increase the array size. Since the size 
of an array object cannot be changed once the object is created, we need to create 
another array with a larger size than that of the original if we choose to implement 
the second alternative. Note that these are the alternatives for using an array. If we use a 
list (ArrayList or LinkedList), then we do not have to worry about overflow. But, as 
stated at the beginning of the Step 1 section, we are using an array here to practice the 
handling of the overflow condition. 

Since the second alternative is more accommodating and less restrictive to 
the programmer, we will implement this alternative. When the array is full, we will create 
a new array, copy the objects from the original array to this new array, and finally set 
the variable entry to point to this new array. We will set the size of the new array to 
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0 1 2 3 4 5 



Figure 10.1 6 How a new array that is 150 percent of the original array is created. The size of the 
original array is 4. 


1.5 times larger than the original array. This size increment is just an estimate. Any value 
between 125 and 200 percent of the old array is reasonable. You don't want to make it 
too small, say, 105 percent, since that will cause the expand method to be called too fre¬ 
quently. You don't want to make it too large either, since that will likely result in wasted 
space. Figure 10.16 illustrates the process of creating a larger array. 
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entry[count] = newPerson; 
count+t; 

Before I After 


entry 


count = = 2 


entry 


count = = 3 



Figure 10.17 Adding a new Person object to the next available location.The array length is 4. 


Now let's think about how to add a Person object to the array.To add a new ob¬ 
ject, we need to locate a position where we can insert the object. Since we are not 
maintaining Person objects in any particular order, we will add a new person at the 
first available position. If we fill the positions from the low to high indices (0,1,2,...), 
we can use a variable to remember the index of the next available position. Since we 
are using an array, the index of the next available position is also the number of Person 
objects currently in the array, so we will call this variable count. Figure 10.17 illustrates 
the add operation. 

step 2 code First we add a new instance variable count to the class: 


II . 

II Data Members 


private int count; //number of elements in the array, 

//which is also the position at which to add 
II the next Person object 

We modify the constructor to initialize this data member: 

public AddressBookfi nt size) { 
count = 0; 

II sa me as before 
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(Note: Because we defined the first constructor to call the second constructor, we 
can implement this change by rewriting only one constructor instead of two.) The add 
method is defined as follows: 


public void add( Person newPerson) 

assert count >=0 && 

count <= entry.length; 


{ 

Notice the use of the 
assertion feature here. 


if (count == entry. length) { //no more space left, 

expand) ); //create a new, larger array 

} 


II at this point, entry refers to a new, larger array 
entry[count] = newPerson; 
count ++; 


Notice the use of the assertion feature. We place the assert statement to make sure 
the value of count is valid. The expand method is a new private method that creates a 
new, larger array. 


Design Document: The AddressBook Class 

Method 

Visibility 

Purpose 

expand 

private 

Creates a new array that is 150 percent of the 



old array. 


private void expand) ) { 

II create a new array whose size is 150% of 
II the current array 

i n t newLength = (int) (1.5 * e nt r y. I e n g t h ) ; 

Person)] temp = new Person) newLength]; 

II now copy the data to the new array 
for (int i = 0; i < entry.Iength; i ++) { 
t e mp [ i ] = e n t r y [ i ] ; 

} 

//finally set the variable entry to point to the new array 
entry = t e mp; 

System, out. p r i n 11 n (" Inside the method enlarge 11 ); II TEMP 


www.it-ebooks.info 








10.7 Sample Development 617 


} 


System, out. p r i n 11 n ( " Size of a new array: " 

+ entry. length); //TEMP 


We will write a test program to verify that a new Person object is added to the 
array correctly. In addition, we need to test that a new array 150 percent larger than the 
old one is created when there are no more spaces left in the array. The test data are as 
follows: 


Step 2 Test Data 

Test Sequence 


Purpose 

Create the array of size 4. 


Test that the array is created correctly. 

Add four Person objects. 


Test that the Person objects are added 
correctly. 

Add the fifth Person object. 


Test that the new array is created and the 
Person object is added correctly (to the new 
array). 


The step 2 test program is as follows: 


Chapter 10 Sample Program: A test main program for 
verifying the step 2 AddressBook class. 

File: TestAddressBook.java 


class TestAddressBook { 

public static void mai n(Stri ng[] args) { 

AddressBook my Book; 

Person person; 

my Book = new Addr essBookf 4) ; 

//add four Person objects 

for ( i nt i =0; i <4; i + + ) { 

person = new Person! “Ms. X" + i, 10, ' F' ); 
myBook. add(person); 

} 

II add the fifth person and see if 
II a new array is created 
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10.7 Sample Development— continued 


person = new Person! "fifth one", 10, ' F' ) ; 
myBook. add(person) ; 

} 

} 


Run the program several times with different sizes for the address book and verify 
that we get the correct results. 

Step 3 Development: Implement the search Method 

step 3 In the third development step, we implement the search method.This method can return 

design one or more Person objects that meet the search criteria. We have several options for the 

search criteria. Since we keep track of name, age, and gender for each person, we can use any 
one of these values as the search criterion. In this implementation, we will use the person's 
name. The search routine for the other two criteria will be left as an exercise (see Exercise 14). 

To implement the search method, we will make an assumption that the name is 
unique so that there will be at most one matching Person object. If the name is not 
unique, then there are two possibilities.The search method can return one Person ob¬ 
ject (among many) that matches the given name or return all Person objects that 
match the given name. We will leave the case when the name is not unique as an ex¬ 
ercise (see Exercise 14). Notice that the add method we implemented in step 2 does 
not check the person data. In other words, there is no mechanism to disallow the addi¬ 
tion of a Person object with a duplicate name. We will leave the implementation of the 
modified add method as an exercise (see Exercise 16). 

There are two possible outcomes with the search method—a successful or an un¬ 
successful search. The method has to return a value by which the programmer can verify 
the result of the search. We will define the search method so that it will return a match¬ 
ing Person object if it is found and will return null otherwise.The search routine will start 
scanning the array from the first position until the desired Person object is found (suc¬ 
cessful search) or until no more Person objects are left in the array (unsuccessful search). 
Expressing the search routine in pseudocode, we have 

I oc = 0; 

while (I oc < count && 

name of Person at ent r y[ I oc] ! = searchName) { 



1 oc ++; 


} 



i f 

(1 oc == count ) 

{ 


foundPerson = 

nu 

} 

else { 
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step 3 code 


step 3 test 


f oundPerson = e nt r y [I oc ] ; 

} 

return f oundPerson; 


Translating the pseudocode to an actual method will result in the following method: 


public Person search(String searchName) { 

Person foundPerson; 
i nt I oc = 0; 

assert count >= 0 && count <= entry.I ength; 

while (I oc < count && 

! sear chName. equal s( ent ry[ I oc] . get Name] ) ) 


I oc ++; 


} 


if (I oc == count ) { 
foundPerson = null; 

} else { 

foundPerson = entry[l oc] 

} 

return foundPerson; 


To test the search method, we will build an address book that contains five 
Person objects. We will give names Ms.XO, Ms.XI, ..., and Ms.X4 to them. After the 
address book is set up, we test various cases of the search. We test for successful and 
unsuccessful searches. For the successful searches, we test for the end cases and nor¬ 
mal cases.The end cases involve searching for persons stored in the first and last posi¬ 
tions of the array. Off-by-1 error (OBOE) is very common in processing an array, so it is 
very important to test these end cases. 

After a successful execution, we will test the class again by changing the size of 
the array. One test size we should not forget to test is the end case for the array size, which 
is 1. Also, we need to test the cases where the array is not fully filled, such as an array of 
size 5 containing only two Person objects. 

The test data are as follows: 


Step 3 Test Data 

Test Sequence 

Purpose 

Create the array of size 5 and add 

Test that the array is created and set up 

five Person objects with unique 

correctly. Here, we will test the case where 

names. 

the array is 100 percent filled. 

Search for the person in the first 

Test that the successful search works 

position of the array. 

correctly for the end case. 
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10.7 Sample Development— continued 


Search for the person in the last 
position of the array. 

Search for a person somewhere 
in the middle of the array. 

Search for a person not in the array. 

Repeat the above steps with an array 
of varying sizes, especially the array 
of size 1. 

Repeat the testing with the cases where 
the array is not fully filled, say, array 
length is 5 and the number of objects 
in the array is 0 or 3. 


Test another version of the end case. 

Test the normal case. 

Test for the unsuccessful search. 

Test that the routine works correctly for 
arrays of different sizes. 

Test that the routine works correctly for 
other cases. 


The step 3 test program is written as follows: 



Chapter 10 Sample Program: A test main program for 
verifying the step 3 AddressBook class. 


File: TestAddressBook.j ava 

*/ 

class TestAddressBook { 

AddressBook my Book; 

Person person; 

public static void mai n(Stri ng[] args) { 

TestAddressBook tester = new TestAddressBook (); 
t est er. s et up Ar r a y( 5) ; 
tester. testSearchf); 

} 

public void setupArrayfint N) { 
my Book = new AddressBook! N ); 

II add N Person objects 

for ( i nt i =0; i < N; i + + ) { 

person = new Person! “Ms. X" +i, 10, ' F' ); 
myBook. add(person) ; 

} 

} 
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public void testSea 

r c h ( ) { 




II test for the e 

nd case 




person = my Book. 

search!" 

Ms. 

X 2" ] 

1 ; 

if (person == nu 

ID { 




Syst em. out. 

p r i nt 1 n 




("Error: 

Didn't f 

i nd 

t he 

person it 

} else { 





Syst em. out. 

p r i nt 1 n 




( per son, g 

e t N a me () 

+ ' 

1 i s 

found oka 


} 

} 

} 


Notice the TestAddressBook class is now an instantiable main class. Since the code 
for testing is getting longer, it is not practical anymore to do everything in a single main 
method. For testing, we will modify the method body of setupArray and testSearch as 
necessary to test all other cases described in the test data table. 

Step 4 Development: Implement the delete Method 

step4 In the fourth development step, we implement the delete method.To delete a Person 

design object, the programmer must somehow specify which Person object to remove from the 

address book. As we did with the search method, we will use the name of a person to 
specify which person to delete. Since we assume the name is unique, the delete method 
will remove at most one Person object.There are two possible outcomes: the specified 
person is removed from the address book (successful operation) and the specified person 
is not removed because he or she is not in the address book (unsuccessful operation). 
We will define the delete method so that it will return true if the operation is successful 
and false otherwise. 

The removal of an element in an array of objects is done by setting the element to 
null. This will leave a "hole." We will fill this hole by replacing the removed element with 
the last element, as explained earlier (see Figure 10.8).This filling operation is necessary 
for other methods, specifically the add method, to work correctly. 

To fill the hole, we need to know the location of the hole.To find this location, we 
write a private search method called findlndex.The method is very similar to the search 
method. The only difference is that the return value of findlndex is an index of an ele¬ 
ment in the array, whereas the return value of search is a Person object. By using this 
findlndex method, the delete method can be expressed as 

boolean status; 

int I oc; 

loc = findlndex! searchName ); 
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10.7 Sample Development— continued 


if (I oc is not valid ) { 

status = false; 

} else { //found, pack the hole 

replace the element at index loc+1 by the last element 
at index count; 

status = t rue; 

count--; //decrement count, 

//since we now have one less element 

assert count is valid; 

} 

return status; 

step 4 code The private findlndex method will look like this: 

private int findlndex(String searchName) { 
i nt I oc = 0; 

assert count >=0 && count <= entry. I ength; 
while ( I oc < count && 

! searchName, equal s ( e n t r y [ I oc], g e t N a me ())) { 



1 oc ++ 


} 



i f 

(loc 

= = count ) 


1 oc = 

NOT_ FOUND 

} 



return 1 

oc; 


The constant NOT_FOUND is set in the data member section as 


II . 

II Data Me mb e r s 
II . 

private static final int NOT_F0UND = -1; 

By using this findlndex method, the delete method is defined as follows: 

public boolean del ete(Stri ng searchName) { 
boolean status; 
int I o c; 

loc = fi ndl ndex(searchName); 
if (loc == NOT_ FOUND) { 
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step 4 test 


status 

= false; 


else { i 

'/found, pack the hole 


entryj 1 

oc] = ent ryfcount - 1]; 


status 

= true; 


count-- 

■ ; / / d e c r e me n t count, 



//since we now have one 

less e 1 e me n t 

assert 

count >= 0 && count <= entry.1 

engt h; 


} 

return status; 

} 

To test the delete method, we will build an address book that contains five Person 
objects, as before. Test cases are to delete the first person in the array, delete the last per¬ 
son in the array, delete someone in the middle (normal case), and try to delete a nonexis¬ 
tent person. 

After a successful execution, we will test the class again by changing the size of an 
array. One test size we should not forget to test is the end case for the array size, which is 
1. Also, we need to test the cases where the array is not fully filled, such as an array of size 
5 containing only two Person objects. 

The test data are as follows: 


Step 4 Test Data 

Test Sequence 

Create the array of size 5 and add five 
Person objects with unique names. 

Purpose 

Test that the array is created and set up 
correctly. Here, we will test the case where 
the array is 100 percent filled. 

Search for a person to be deleted next. 

Verify that the person is in the array 
before deletion. 

Delete the person in the array. 

Test that the del e t e method works 
correctly. 

Search for the deleted person. 

Test that the del e t e method works 
correctly by checking that the value n u 1 
is returned by the search. 

Attempt to delete a nonexistent person. 

Test that the unsuccessful operation works 
correctly. 

Repeat the above steps by deleting 
persons at the first and last positions. 

Test that the routine works correctly for 
arrays of different sizes. 

Repeat testing where the array is not fully 
filled, say, an array length is 5 and the 
number of objects in the array is 0 or 3. 

Test that the routine works correctly for 
other cases. 
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The step 4 test program is written as follows: 



Chapter 10 Sample Program: A test main program for 
verifying the step 4 AddressBook class. 

File: TestAddressBook.j ava 

*1 


class TestAddressBook { 
AddressBook my Book; 
Person person; 


public static void mai n(Stri ng[] args) { 

TestAddres sBook tester = new TestAddress Book () ; 
t est er. s et up Ar r a y ( 5 ) ; 
tester.test Delete! ) ; 


public void setupArrayfint N) { 
my Book = new AddressBook) N ); 

II add N Person objects 

for ( i nt i = 0 ; i < N; i + + ) { 

person = new Person! “Ms. X" + i, 10, ' F' ); 
myBook. add(person) ; 

} 

} 

public void test Delete! ) { 

//first make sure the person is in the array 

person = myBook. search! “Ms. X2" ); 


if (person == null) { 

System, out. println!" Error: Didn't find the person it 

} else { 


System, out. pri ntl n(person.getName!) + " is found okay 
boolean success = myBook, delete! “Ms. X 2" ); 
if (success) { 


person = myBook. search! "Ms. X2" ); 
if (person == null) { 


s h o u I d" ); 
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} 


System, out. pri ntl n ( 

"Okay: 

Del et i 

s e { 



ystem. out. pri ntl n(" 

Error: 

Person 


} 

} else { 

System, out, pri ntl n(" Error: Deletion has a problem"); 

} 


Modify the method body of setupArray and testDelete as necessary to test all 
other cases described in the step 4 test data table. 

Step 5 Development: Finalize 

program As always, we finalize the program in the last step. We perform a critical program review 

review to fi nc | an y inconsistency or error in the methods, incomplete methods, places to add 

comments, and so forth. 

final test Since the three operations of add, delete, and search are interrelated, it is critical 

to test these operations together. The test program should try out various combinations 
of add, delete, and search operations to verify that they work together correctly. 

After we complete the class implementation and testing, we may consider 
improvement or extension. In addition to the several alternative designs, it is possible 
to add other operations. For example, we may want to add an operation to modify a 
Person object. Another common operation that is useful in manipulating a collection 
of objects is the traversal operation described in Section 10.6. Implementation of this 
operation is left as Exercise 17. 


Summary 


• An array is an indexed collection of data values. 

• Data values in an array are called array elements. 

• Individual elements in an array are accessed by the indexed expression. 

• Array elements can be values of primitive data type or objects. 

• In Java, an array can include only elements of the same data type. 

• A Java array is a reference data type. 

• A Java array is created with the new operator. 

• An array can have multiple indices. 
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W hen an array is passed to a method as an argument, only a reference to an 
array is passed. A copy of an array is not created. Note: The reference to an 
array we are passing is a value of an array variable, and therefore the call- 
by-value scheme is used here also. 

The standard classes and interfaces described or used in this chapter are 


List 

Iterator 

ArrayList 

Map 

LinkedList 

HashMap 


TreeMap 


The Java Collection Framework includes many data structure classes such as 
lists and maps. 

The List interface represents a linear ordered collection of objects. 

The ArrayList and LinkedList classes aretwo implementations of the List 
i nterface. 

The Map interface represents a collection of key-value pairs. 

TheTreeMap and HashMap classes aretwo implementations of the Map 
i nterface. 


Key Concepts 

arrays 


arrays of objects 

array elements 


multidimensional arrays 

index expression 


lists 

arrays of primitive data type 

maps 

Chapter 10 Exer 

c i s e s 



Review Exercises 

1. Identify problems with this code: 

public int searchAccount ( i nt [ 25 ] number ) { 
number = new i nt [ 15 ] ; 

for (int i = 0; i < number. I ength; i ++) { 
number [ i ] = number [ i - 1 ] + number [i+1]; 

} 

return number; 

} 

2. Declare an array of double of size 365 to store daily temperatures for one 
year. Using this data structure, write a code fragment to find 

• The hottest and coldest days of the year. 

• The average temperature of each month. 
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• The difference between the hottest and coldest days of every month. 

• The temperature of any given day. The day is specified by two input 

values: month (1, ..., 12) and day (1, ..., 31). Reject invalid 

input values (e.g., 13 for month and 32 for day). 

3. Repeat Exercise 2, using a two-dimensional array of double with 12 rows 
and each row having 28, 30, or 31 columns. 

4. Repeat Exercise 2, using an array of Month objects with each Month object 
having an array of double of size 28, 30, or 31. 

5. For Exercises 2 to 4, the following three data structures are used: 

• One-dimensional array of double of size 365. 

• Two-dimensional array of double with 12 rows. Each row has 28, 30, 
or 31 columns. 

• An array of Month objects with each Month object having an array of 
double of size 28, 30, or 31. 

Discuss the pros and cons of each approach. 

6. Suppose you want to maintain the highest and lowest temperatures for every 
day of the year. What kind of data structure would you use? Describe the 
alternatives and list their pros and cons. 

7. If a car dealer's service department wants a program to keep track of 
customer appointments, which data structure should they choose, an array 
or a list? If the number of appointments the service department accepts is 
fixed on any given day, which data structure is appropriate? W hat are the 
criteria you use to decide which data structure to use? Explain. 

8. In Figure 10.8, the last statement 

p e r s o n [ I a s t ] = nul I ; 

is significant. Show the state-of-memory diagram when the last statement is 
not executed. 

9. Declare a two-dimensional array for the tuition table shown in Figure 10.13. 

10. Suppose you want to maintain information on the location where a product 
is stored in a warehouse. Would you use a three-dimensional array such as 
location[i][j][k], where i is the warehouse number, j is the aisle number, and 
k is the bin number? Or would you define three classes Warehouse, Aisle, 
and Bin? Describe the alternatives and list their pros and cons. 


Level 1 Programming Exercises ★ 

11. W rite a program that computes the standard deviation of N real numbers. 
The standard deviation s is computed according to 


5 = 


/Ul - x) 2 + (X2 


x ) 2 + ■ ■ ■ + (xjv — x ) 2 
N 
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The variable jc is the average of N input values xi through x N . The program 
first prompts the user for N and then declares an array of size At 

12. Repeat Exercise 11, using an ArrayList. 

13. Using the payScaleTable two-dimensional array from Section 10.4, writea 
program to find 

• The average pay for every grade level 

• The average pay for every step (i.e., average of every column) 

Y ou do not have to i nput the data val ues. J ust assi gn the val ues to the 
payScaleTable array in the program. 

14. The search method Of the AddressBook class returns only one Person 
object. M odify the method so that it will return all Person objects that 
match the search criteria. You can use an array to return multiple Person 
objects. 

15. Write new search routines for the AddressBook class. The search method 
given in the chapter finds a person with a given name. Add second and 
third search methods that find all persons, given an age and a gender, 
respectively. 

16. M odify the add method of the AddressBook class. The method given in the 
chapter does not check for any duplicate names. M odify the method so that 
no Person object with a duplicate name is added to the address book. 


Level 2 Programming Exercises ★★ 

17. M odify the AddressBook class to allow the programmer to access all Person 
objects in the address book. M ake this modification by adding two methods: 
getFirstPerson and getNextPerson. The getFirstPerson method returns the 
first Person object in the book. The getNextPerson method returns the next 
Person object if there is one. If there is no next person in the book, 
getNextPerson returns null. The getFirstPerson method must be called before 
the getNextPerson method is called. 

18. Using a list (either an ArrayList or a LinkedList), write a fortune telling pro¬ 
gram. Repeatedly prompt the user with the message 

Fortune (y/N)? 

If the user enters Y, then display a randomly selected fortune from the list. If 
the user enters N, then stop the program. Define the class named Fortune. 
You can define and use a separate main class or include the main method in 
the Fortune class. Create the fortune list in the constructor. Include at least 
10 fortunes. The following are sample fortunes you can use: 


You wiI I qet 
Happi ness is 
Satisfaction 
Patience is 


4,0 GPA this 
pr og r a mmi ng. 
f oI I ows hard 
v i r t u e, 


s e me s t e r. 

work. 
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19. A codon is a triplet of nucleotides that specifies a single amino acid (a pro¬ 
tein is a sequence of amino acids). Write a program that extracts codons 
found in an input DNA (or RNA) sequence and stores them in an ArrayList. 
For example, if the input is GATTCGATC, the program stores GAT, TCG, 
and ATC in an ArrayList. If the length of an input string is not a multiple 

of 3, then ignore any leftover nucleotides. For example, if the input is 
GATTCGA, then store GAT and TCG. Output codons in the list using the 
for-each loop. Repeat the operation until an empty string is entered. 

Level 3 Programming Exercises ★★★ 

20. In addition to the List and Map interface, the third interface in the Java 
Collection Framework is Set. A Set is an unordered collection of objects with 
no duplicates. This interface models, as expected, the mathematical set. Two 
cl asses that implement the Set interface in JCF areTreeSet and HashSet. 

H ere's a simple example of using Set: 

Set <S t r i n g > = new HashSet «=S t r i n g ><); 
set. add("ape" ); 
set. add("bee" ); 

set. add("ape" ); //duplicate, so it won't be added 
s e t. a d d ( " c a t" ) ; 
set. r e mo v e (“ b e e" ); 

set. re mo v e (" dog"); II not in the set, nothing happens 
System, out. println(" Set = 11 + set); 

The output from the code will be 


Set = [ape, cat] I 

To access the i ndi vi dual el ements of a set, cal I the iterator method i n the 
manner identical to the one we used for the List interface. 

Rewrite the AddressBook class by using the HashSet instead of an array 
to maintain a collection of Person object. 

21. Consider the following Thesaurus class: 

cl ass Thesaurus { 

//Returns all synonyms of the word as a Set 

//Returns null if there is no such word 

publ ic java.util. Set<5tring>get (String word){. ..} 

//Returns all key words in this thesaurus as a Set 
//returns an empty set if there are no keys (if you 
II don't do anything, default behavior of the 
//underlying JCF class will handle it) 
publ ic java.util. Set<5tring>keys( ){■■■} 

II Adds 'synonym' to the synonym set of 'word' 

//Pay close attention to this method. 

publ i c voi dput (String word, String synonym){. ..} 

} 
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The get method returns a set of all synonyms of a given word. The keys 
method returns all key words in the thesaurus. The put method adds a 
new synonym to the given word. M ake sure to handle the cases when 
the word already has a synonym list and when the word is added for the 
first time. Using this Thesaurus class, we can write, for example, this 
program: 

cl ass Samp I e Ma i n { 

publ i c stati c voi d ma i n { St r i ng [] a r gs ) { 

Thesaurus t = new Thesaur us (); 
t. p u t (" f a s t " , "speedy"); 
t. put (" f ast " , " swift" ) ; 
t. put (" s I ow" , "sluggish"); 

Set <Stri ng> synonyms = t. g e t (“ f a s t “ ); 

System, out. pri ntl n(synonyms); 

System, out. pri ntl n(t. k e y s ()); 

} 

} 

When the sample program is executed, the output will be 


■ C:\WINNT\System3Z\cmd.eHe 


[speedy, swift] 

[fast, slow] 

Pr ess any key to continue 


Implement the Thesaurus class, using one of the Map classes. The key is the 
word, and the value is the set of synonyms of this word. 

22. Write a program that allows the user to search an element in the periodic 
table by the element's name or symbol. Use the Element class presented in 
Chapter 4. For this exercise, use an array. Would itbel-D or2-D array? 
How big is the size of your array? Declare the array large enough to store 
all 113 elements. Note: There's no element with atomic number 113. 
Elements with atomic numbers 112 and 114 do not have symbols and 
names. Since we have not covered file input and output (Chapter 12), create 
around a dozen or so Element objects inside the program in the following 
manner: 

EI e me n t e I e me n t; 

e I e me n t = new Ele me nt(" Hydrogen", 1, " H" , 1.00794, 1, 1); 

II add element to the periodic table array 

e I e me n t = new Ele me n t ( " Helium", 2, "He", 4.00260, 1, 18); 

II add element to the periodic table array 

II and so forth 
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After the periodic table array is created and populated with elements, prompt 
the user with menu choices 

1. Search by Name 

2. Search by Symbol 

3. Quit 

W hen the user enters 1, prompt the user for the name and search the periodic 
table array for the element with the given name. W hen the user enters 2, 
prompt the user for the symbol and search the peri odi c tabl e array for the 
element with the given symbol. If an element is found, display its atomic 
number, symbol, name, and mass. If an element is not found, then display an 
appropriate message. Repeat the process. Terminate the program when the 
user enters 3. 

23. Repeat Exercise 22 using a HashM ap or aTreeM ap instead of an array. 

What would be the key of the map structure? If it is the element's name, 
how would you carry out the operation for search by symbol? Similarly, if 
the element's symbol is the key, how would you carry out the operation for 
search by name? Consider using two map structures, one with the symbol as 
the key and the other with the name as the key. 

Development Exercises 

For the following exercises, use the incremental development methodology to 
implement the program. For each exercise, identify the program tasks, create a 
design document with class descriptions, and draw the program diagram. M ap 
out the development steps at the start. Present any design alternatives and 
justify your selection. Be sure to perform adequate testing at the end of each 
development step. 

24. Write a complete address book maintenance application. The user of the 
program has four options: Add a new person, delete a person, modify the 
data of a person, and search for a person by giving the name. Use the 
AddressBook class, either the original one from the chapter or the modified 
one from the previous exercises. You have to decide how to allow the user 
to enter the values for a new person, display person information, and so 
forth. 

25. Design a currency converter class whose instance will handle conversion of 
all currencies. A single instance of the new currency converter class you 
design here will handle all currencies. Instead of having specific conversion 
methods such as toDollar, toYen, and so forth, the new currency converter 
class supports one generic conversion method called exchange. The method 
has three arguments: fromCurrency, toCurrency, and amount. The first two 
arguments are string and give the names of currencies. The third argument is 
float. To convert $250 to yen, we write 

yen = converter. exchange( "dollar", "yen", 250.0 ); 
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To set the exchange rate for a currency, we use thesetRate method. This 
method takes two arguments: The first argument is the currency name, and 
the second argument is the rate. For example, if the exchange rate for yen is 
140 yen to $1, then we write 

converter, set Rate( “yen' 1 , 140.0 ); 

U se an array to keep track of exchange rates. 

26. Extend the Myjava Lo-Fat Burgers drive-through ordering system of 
Exercise 24 on page 302 so the program can output sales figures. For each 
item on the menu, the program keeps track of the sales. At closing time, 
the program will output the sales figure in a format similar to the 
following: 


Item 

Tofu Burger 
Cajun Chicken 

Today's Total Sales: $ 2761.20 

27. Redo the watermelon projectile computing program of Exercise 31 on 
page 371 to output the average distance covered between each time interval. 
Use the expression 

V(x 2 - JCl) 2 + (y 2 - yip 

to compute the distance between two coordinate points Ui, yy) and (x 2l y 2 ). 

28. Redo the social club program of Exercise 12 on page 494. In the original 
program, we limitthe number of clubs to 5. Remove this restriction by using 
an array. 

29. Redo Exercise 28, but this time use one of the Java Col lection Framework 
classes. 


Sales Count Total 

25 $ 87.25 

30 $137.70 
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Objectives 


After you have read and studied this chapter,you 
should be able to 

• Perform linear and binary search algorithms on 
arrays. 

• Determine whether a linear or binary search is 
more effective for a given situation. 

• Perform selection and bubble sort algorithms. 

• Describe the heapsort algorithm and show 
how its performance is superior to that of the 
other two algorithms. 

• Apply basic sorting algorithms to sort an 
array of objects, using the Comparator 
interface. 

• Define the interface to specify common 
behavior and provide different versions of 
classes that implement the interface. 
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Introduction 



n this chapter, we cover searching and sorting. In Chapter 10, we presented a case 
study of maintaining an address book and described a basic searching method to 
locate a student, given hi s or her name. I n thi s chapter, we w i 11 present a better search- 
ing algorithm called binary search. To apply binary search, an array must be sorted. 
Sorting is a technique to arrange elements in some order, and it is one of the funda¬ 
mental operations we study in computer science. We will cover basic sorting algo¬ 
rithms in this chapter and an efficient recursive sorting algorithm in Chapter 15. We 
will use an array of integers to illustrate searching and sorting algorithms, but all the 
techniques we present here are equally applicable to any array of objects as well as 
other primitive data types. In the sample development (Section 11.4), we will extend 
the AddressBook class by adding the capability of sorting an array of Person objects. 


11.1 Searching 

Let's start with the problem statement for searching: 

Given a value X, return the index of X in the array, if such X exists. 
Otherwise, return NOT_FOUND ( — 1). We assume there are no duplicate 
entries in the array. 

There are two possible outcomes in searching: Either we locate an X or we don't, 
successful and We will call the first a successful search and the latter an unsuccessful search. 
unsuccessful Figure 11.1 illustrates the successful and unsuccessful searches. As obvious as this 

searches ma y j t j s cr jtical to differentiate the two because it is possible for one search¬ 

ing algorithm to perform superbly for successful searches, but very poorly for 
unsuccessful searches. W hen we analyze the performance of a searching algorithm, 
we normally derive two separate performances, one for a successful search and 
another for an unsuccessful search. 


Linear Search 

linear search The search technique we used earlier in the book is called a lin r - ncfi because 
we search the array from the first position to the last position in a linear progression. 


Unsuccessful search: search(45) -► N OT_FOU N D ( —1) 


Successful search: search( 12) -► 4 



Figure 11.1 Successful and unsuccessful searches. 
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binary search 


Thelinear search isalso called a sequential search. Thelinear search algorithm can 
be expressed as 

public int MnearSearch ( i n t [ ] number, int searchValue) { 

i nt I oc =0; 

More elements 
to search 

while ( I oc < number .length && 

number[l oc] != searchValue ) { 

searchValue is 

} not yet found. 

if (loc == number. length) { //Not found 

return NOT_FOUND; 

} else { 

return loc; //Found, return the position 

} 

} 

If the number of entries in the array is TV, then there will be AT comparisons for 
an unsuccessful search (i.e., you search for a value not in the array). In the case of a 
successful search, there will be a minimum of one comparison and a maximum of 
N comparisons. On average, there will be approximately N/2 comparisons. 

Is there a way to improve the linear search? If the array is sorted, then we can 
i mprove the search routi ne by usi ng the bi nary search techni que. 

Binary Search 

If the values in the array are arranged in ascending or descending order, then we 
call the array sorted. In the foil owing explanation of the binary search, we assume 
the array is sorted in ascending order. The crux of binary search is the winning 
strategy you apply for the Hi-Lo game. When you try to guess a secret number, 
say, between 1 and 100, your first guess will be 50. If your guess is HI, then 
you know the secret number is between 1 and 49. If your guess is LO, then you 
know the secret number is between 51 and 100. By guessing once, you eliminated 
one-half of the possible range of values from further consideration, this is the core 
idea of binary search. 

Consider the following sorted array: 

number 


1 1 

0 

1 

2 

3 

4 

5 

6 

7 

8 


5 

12 

17 

23 

38 

44 

77 

84 

90 


Let’s suppose we are searching for 77. We first search the middle position of the 
array. Since this array has 9 elements, the index of the middle position is 4, so we 
search number[4]. The value 77 is notin this position. Since 77 is larger than 38 and 
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012345678 


5 

12 

17 

23 

38 

44 

77 

84 

90 


number!i] < 38 

Search 


38 < number[i] 


77 must be in this 

half of the array. 

V_.. _ J 


012345678 



44 

77 

84 

90 


No need to consider I_ 

the left half anymore. | 

Search 


Figure 11.2 Effect of one comparison in binary search. 


the array is sorted, we know that if 77 is in the array, it must be in the right half of 
the array. So next we search the middle position of the right half of the array, which 
is position 6. Figure 11.2 illustrates the effect of making one comparison in the 
binary search. 

The search value 77 was found after two comparisons. In contrast, the linear 
search would take seven comparisons to locate 77. So there is a net reduction of five 
comparisons. How good is the binary search in general? Let's study the worst-case 
situation. In the binary search, after we make one comparison, we can eliminate 
one-half of the array from further consideration. So the number of comparisons in 
the worst case is the number of times you can divide the array into halves. Suppose 
the original size of an array is N and the value we are searching for is not in the 
array. Then after one comparison, we have to search the remaining N/2 elements. 
After two comparisons, we have to search 7V/4 elements, and so on. The following 
table shows this relationship. The left column is the number of comparisons, and 
the right column is the number of elements we still need to search after making K 
comparisons. 
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The maximum number of comparisons K is derived by solving the equation 

N = 2 K 
log 2 N = K 

This is a remarkable improvement. If the size of the original array is 2048, for exam¬ 
ple, then the unsuccessful binary search takes at most log 2 2048 = 11 comparisons, 
while the unsuccessful linear search takes 2048 comparisons. The difference be¬ 
tween the two algorithms gets larger and larger as the size of an array increases. 

Now let's write a binary search method. The key point in the method revolves 
on how to stop the search. If the search value is in the array, we will eventually 
locate it, so the stopping condition for the successful search is easy. W hat about the 
case for an unsuccessful search? How can we detect that there are no more elements 
in the array to search for? Should we use some kind of a counter? We certainly 
can use a counter, but we can implement the method without using any counter. To 
compute the middle location for the next comparison, we need two indices— low 
and high. The low and high indices are initialized to Oand/V- 1, respectively. The 
middle location is computed as 

mid = (low + high) / 2; II the result is truncated 

If number[mid] is I ess than the search value, then low is reset to mid+i. If 

number[mid] is greater than the search value, then high is reset to mid-i, and the 
search continues. Eventually, we will locate the search value or we will run out of 
elements to compare. We know that there are no more elements to compare when 
low becomes larger than high. Figure 11.3 shows how this works. 

H ere's the binarySearch method: 

public int binarySearch ( i n t [ ] number, int searchValue) { 

i nt low =0, 

high = number.length - 1, 
mid = (low + high) / 2; 

while (low <= high && n u mb e r [ mi d ] != searchValue) { 

if (number! mid] < searchValue) { 
low = mi d + 1; 

} else { //number! mid] > searchValue 

high = mi d - 1; 

} 

mid = (low + high) / 2; 

} 

if (I ow > hi gh) { 
mi d = NOT FOUND; 

} 

return mi d; 

} 
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Quick 

CHECK 

V 


1. Suppose an array contains 2048 elements. W hat are the least and the greatest 
numbers of comparisons for a successful search using linear search? 

2. Repeat question 1 for a binary search. 


11.2 


Sorting 


In this section we will describe two basic sorting algorithms. A more advanced 
sorting algorithm will be presented in Section 11.3. Let's start with the problem 
statement for sorting: 


Given an array of N values, arrange the values into ascending order. 


Selection Sort 

Given a list of integers, how would you sort them? The most natural sorting algo¬ 
rithm for a human looks something like this: 

1. F i nd the smal I est i nteger i n the I i st. 

2. Cross out the number from further consideration and copy it to a new 
(sorted) list. 

3. Repeat steps 1 and 2 until all numbers are crossed out in the list. 
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Figure 11.4 


selection sort 
sorting passes 


Figure 11.5 



Human sorting algorithm after three numbers are moved to the sorted list. 


Figure 11.4 shows this human sorting algorithm with the first three numbers being 
copied to the new list. 

We can write a computer program based on this sorting algorithm, but the re¬ 
sulting program will not be a good one. There are two problems. First, we need an 
extra array to keep the sorted list. This may not sound like much, but when you con¬ 
sider an array of, say, 10,000 elements, using a second array is very wasteful. Sec¬ 
ond, crossing out numbers is effective for humans only. We humans can see the 
cross marks and will not consider the numbers once they are crossed out, but in 
computer programs, we still have to write code to check every element to see 
whether it is crossed out. We can "cross out" an element by replacing it with a neg¬ 
ative number, say, -1, if the numbers are all positive. If not, then we have to use 
other means to cross out an element. So crossing out the numbers does not reduce 
the number of comparisons in the program. 

Although wedo notwantto implement this human sorting algorithm as is, we 
can derive an algorithm based on the idea of finding the smallest number in a given 
list and moving itto the correct position in the list. This sorting algorithm is called 
selection sort 

The selection sort is comprised of sartingpt . Figure 11.5 shows the effect 
of the first pass on a sample array of N (= 9) elements. First we locate the smallest 


start min 


012345678 


23 

17 

5 

90 

12 

44 

38 

84 

77 


t_t 



Exchange 



0 

1 

2 

3 

4 

5 

6 

7 

8 



5 

17 

23 

90 

12 

44 

38 

84 

77 













Sorted 

U nsorted 


Effect of executing the first pass in the selection sort. 
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Pass 



0 

1 

2 

3 

4 

5 

6 

7 

8 

1 

23 

17 

5 

90 

12 

44 

38 

84 

77 
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5 
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Sorted 


Pass 


012345678 


5 

12 

17 

23 

90 

44 

38 

84 

77 


t_J 

4 5 6 7 8 

0 12 3 

5 

12 

17 

23 

38 

44 

90 

84 

77 


u 

5 6 7 8 

0 12 3 4 

5 

12 

17 

23 

38 

44 

90 

84 

77 


t_ i 

6 7 8 

0 1 2 3 4 5 

5 

12 

17 

23 

38 

44 

77 

84 

90 


u 


Figure 11.6 Eight passes to sort the sample array of nine elements. 


element in the array and set the index min to point to this element. Then we 
exchange number[start] and number[min]. After the first pass, the smallest element 
is moved to the correct position. We increment the value of start by 1 and then 
execute the second pass. We start the first pass with start = o and end the last pass 
with start = N- 2 . Figure 11.6 shows the sequence of eight passes made to the 
sample array. 

Here's the selectionSort method: 

public void sel ecti onSort(i nt[] number) { 

int minlndex, length, temp; 
length = number.length; 

for (int startl ndex = 0; startlndex <= length-2; 

s t a r 11 ndex ++) { 

//each iteration of the for loop is one pass 

minlndex = startlndex; 

//find the smallest in this pass at 
//position minlndex 

for (int i = s t a r 11 n de x+ 1; i <= length-1; i++) { 
if ( n u mb e r [ i ] < number! minlndex]) minlndex = i; 

} 
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//exchange number[startl ndex] and number! mi nl ndex] 

temp = numb er[startl ndex]; 

number[startl ndex] = number[mi nl ndex]; 

number[mi nl ndex] = temp; 

assert mi nStartfnumber, startlndex): 

"Error: " + number[startl ndex] + 

' at position " + startlndex + 

■ is not the s ma I I e s t. "; 

} 

assert isSorted(number); 

"Error: the final is not sorted"; 

} 

The assertion at the end of one pass confirms that the smallest element in that pass 
moved to the beginning position of the pass. The minstart method is therefore 
written as follows: 

private boolean mi nStart(i nt[] number, int startlndex) { 
for (int i = startl ndex+1; i < number. I ength; i ++) { 

if (number[startl ndex] > n u mb e r [ i ]) { 

return false; 

} 

} 

return true; 

} 

We put a second assertion at the end of the method to verify that no elements 
are out of place after the sorting is complete. The isSorted method is written as 
follows: 


private boolean isSorted(int[] number) { 

for (int i = 0; i < number. I ength-1; i ++) { 

if ( n u mb e r [ i ] > n u mb e r [ i +1 ]) { 

return false; 

} 

} 

return true; 

} 

Assertion is a very useful tool in a situation such assorting. While developing 
the sorting routines, we insert a number of assertion statements to increase our con¬ 
fidence in the program's correctness. 
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ings to Remember 


Be sure to run programs with assertions enabled during the development, 
but disable them during the actual use. Run the program with assertions 
enabled with 

java - e a <ma in c I a s s > 



We use assertions to find coding error. But what will happen when the code 
we write for assertions, such at the minStart method used in the selection 
sort routine, is wrong? How can we assert that minStart is correct? We do not 
want to write assertions for assertions! One possibility is to create a data set 
that is correct and to run the minStart method against these data to test for 
their validity. The use of assertions is merely an aid, not a fail-safe way to find 
errors. 


Let's analyze the selection sort algorithm. In analyzing different sorting algo¬ 
rithms, we normally count two things: the number of comparisons and the number 
of data movements (exchanges). We will show you how to count the number of 
comparisons here. Counting the number of data movements is left as Exercise 4. 
Keep in mind that the analysis we provide in this chapter is an informal one. A 
detailed analysis is beyond the scope of this book, so we will give only a taste of 
the formal analysis. 

The selection sort has one comparison (the if statement inside the nested-for 
loop), so we can easily count the total number of comparisons by counting the num¬ 
ber of times the inner loop is executed. For each execution of the outer loop, the 
inner loop is executed length - start times. The variable start ranges from o to 
length-2. So the total number of comparisons is computed by finding the sum of the 
right column in the following table: 


Start 

Number of Comparisons 
(Length - Start) 

0 

1 engt h 

1 

length - 1 

2 

length - 2 

length - 2 

2 
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The variable length is the size of the array. If we replace length with N, the 
size of the array, then the sum of the right column is 



N + (N - 1) + (N - 2) + ■ ■ ■ + 2 = £ i = V i - 1 


N(N + 1) . _ n 2 + N-2 


The total number of comparisons is approximately the square of the size of an 
array. This is a quadratic function, so the number of comparisons grows very 
rapidly as the size of an array increases. Is there a better sorting algorithm? The 
answer is yes. 


Bubble Sort 

The effect of one pass of the selection sort is the movement of the smallest element 
to its correct position. Since an array gets sorted only by moving the elements to 
their correct positions, the whole sorting routine will complete sooner if we increase 
the number of data movements. In the selection sort, we make one exchange per 
pass. If we could move more elements toward their correct positions in one pass, we 
could complete the sorting sooner than the selection sort. The bubble sort is one 
such algorithm that increases the number of data movements for the same number 
of comparisons as the selection sort makes. 

The key point of the bubble sort is to make pairwise comparisons and to ex¬ 
change the positions of the pair if they are out of order. Figure 11.7 shows the effect 
of pairwise comparisons in the first pass of the bubble sort. After the first pass, the 
largest element, 90, has moved to its correct position in the array. This is the guar¬ 
anteed effect of one pass. In addition, we notice that many other elements have 
moved toward their correct positions, as bubbles move toward the water's surface. 

In the worst case, the bubble sort will make/V- 1 passes, so the worst-case 
performance is the same as that for the selection sort. However, in the average case, 
we can expect a better performance from the bubble sort. The bubble sort exhibits 
two properties: 

• After one pass through the array, the largest element will be at the end of the 
array. 

• During one pass, if no pair of consecutive entries is out of order, then the 
array is sorted. 

Using these properties, we can express the bubbleSort method in pseudocode: 


This while loop per¬ 
forms at most A/—1 


bottom = nu mb er. length - 2; 
exchanged = true; 


passes for an array 
with A/elements.The 
loop will terminate 
when there are no ex¬ 
changes in one pass. 


while (exchanged) { //continue if the exchange is made 


II do one pass of sorting 

exchanged = false; //reset the variable 
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Notice how the value 90 
migrates toward its correct 
position. In addition, other 
values also move toward 
their correct positions. 


Effect: The largest element 
moves to its correct position. 
Use an assertion to verify 
this condition. 
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Figure 11.7 Effect of executing the first pass in the bubble sort. 
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One pass of 
bubble sort 


for (int i = 0; i <= bottom; i ++) { / /pairwise comparison 
if ( n u mb e r [ i ] > n u mb e r [ i +1 ]) { 

II the pair is out of order 
exchange them; 

exchanged = true; //an exchange is made 

} 

} 

II one pass is done, decrement the bottom index by 1 
bottom--; 


Translating the pseudocode into an actual method, we have 


public void bubbl eSort(i nt[] number) { 

int t e mp, bottom; 

boolean exchanged = true; 

bottom = nu mb er. length - 2; 

while (exchanged) { 

exchanged = false; 

for ( i nt i =0; i <= bot t om; i ++) { 
if ( n u mb e r [ i ] > number[i+l]) { 

temp = n u mb e r [ i ] ; //exchange 

number [ i ] = number [ i +1] ; 

n u mb e r [ i +1 ] = t e mp; 

exchanged = true; //exchange is made 

} 

} 

assert maxBott om( number, bottom): 

"Error: " + n u mb e r [ b o 11 o m] + 

" at position " + bottom + 

" is not the largest."; 


Assert the element at posi¬ 
tion bottom is the largest 
among elements from 
position 0 to bottom. 


bottom--; 

} 

assert isSorted(number): 

"Error: the final is not sorted"; 

} 

The maxBottom method verifies that the largest element among elements from 
position o to bottom is at position bottom. The method is written as follows: 

private boolean maxBottom(int[] number, int lastlndex) { 
for (int i =0; i < lastlndex; i ++) { 
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heapsort 

heap 

root node 


Figure 11.8 


if (number[l astl ndex] < n u mb e r [ i ] ) { 

return false; 

} 

} 

return true; 

} 

On average, we expect the bubble sort to finish sorting sooner than the selec¬ 
tion sort, because there will be more data movements for the same number of 
comparisons, and there is a test to exit the method when the array gets sorted. The 
worst case of the bubble sort happens when the original array is in descending order. 
Notice that if the original array isalready sorted, the bubble sort will perform only 
one pass whereas the selection sort will perform N- 1 passes. 


1. Show the result of the second pass of bubble sort applied to the array at the 
bottom of Figure 11.7. 

2. For an array with N elements, what is the least number of comparisons the 
bubble sort will execute? 


11.3 Heapsort 

Selection and bubble sorts are two fundamental sorting algorithms that take 
approximately TV 2 comparisons to sort an array of N elements. One interesting 
sorting algorithm that improves this performance to approximately 1.5 N log 2 N 
is . We will describe the heapsort algorithm and analyze its performance in 

this section. 

The heapsort algorithm uses a special data structure called a . A heap 
consists of nodes, which contain data values, and edges, which link the nodes. 
Figure 11.8 shows a sample heap. We use integers as data values for the examples 
in this section. The topmost node is called the mat node of a heap. Nodes in a heap 


o 



A sample heap that includes nine nodes. 


www.it-ebooks.info 







11.3 Heapsort 647 


left and right 
children 


heap 

constraints 


are indexed 0, 1, 2, and so forth in the top-to-bottom, left-to-right order, starting 
from the root. A node in a heap has zero, one, or two children. The children of a 
node are distinguished as the node's l&t and sizfitdUlctm. If a node has only one 
child, then it is the left child of the node. 

A heap must satisfy these two constraints: 

1 . Structural constraint. Nodes in a heap with N nodes must occupy the 
positions numbered 0,1,..., N - 1. Figure 11.9 shows examples of 
nonheaps that violate the structural constraint. 

2. Value relationship constraint. A value stored in a node must be larger than 
the maximum of the values stored in its left and right children. Figure 11.10 
shows examples of nonheaps that violate the value relationship constraint. 





Figure 11.10 Sample heaps and nonheaps that violate the value relationship constraint.Violations are 
indicated by blue ellipses. 
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heapsort 

phases 


rebuild step 


How can weuse the heap structure to sort//elements? Heapsort is carried out 
in two phases: 

1. Construction phase. Construct a heap given N elements. 

2. Extraction phase. Pull out the value in the root successively, creating a new 

heap with one less element after each extraction step. 

We will begin the description of heapsort from the extraction phase. Consider the 
heap shown in Figure 11.8. Since every node in the heap satisfies the value rela¬ 
tionship constraint, we can conclude that the value in the root node is the largest 
among the values stored in the heap. Now, after we remove the value 90 from the 
heap, we must create a new heap that has one less element. We can build such a heap 
by first moving the last element (value 23 in the figure) to the root position. With the 
val ue 23 i n the root position, we have met the structural constrai nt for the heap with 
eight elements. However, the value relationship constraint is not met. The violation 
occurs because 23 is smaller than the larger of its two children. By swapping 84 and 
23, the violation is eliminated. Since the value 23 is now at a new location, we must 
check again if the violation occurs at this position. It does, because 77 is larger than 
23, so we swap again. We repeat the process until either there are no more children 
to consider or the value moved into a new position meets the value relationship 
constraint. We will call this process a rebuild st . One rebuild step is illustrated in 
Figure 11.11. 

Using a heap with TV elements, we can sort the given N elements by perform¬ 
ing the rebuild steps N - 1 times. Figure 11.12 illustrates the rebuild steps for the 
sample heap. Notice how the array for the sorted list is filled from the end. All 
we have to do now is to figure out how to build a heap from a given unsorted list of 
//elements. Let's study the construction phase of the algorithm. 

We will illustrate the construction phase with the following unsorted nine 
elements: 

23, 17, 5, 90, 12, 44, 38, 84, 77 

If we assign the given numbers to a heap structure in ascending index order, we 
have the heap structure shown in Figure 11.13. This heap structure is not truly a 
heap because it violates the value relationship constraint. The construction phase 
will eliminate any violations of the value relationship constraint. The key concept 
for the construction phase is the rebuild step we used in the extraction phase. We 
will build a complete heap in a bottom-up fashion. We start out with a small heap 
and gradually build bigger and bigger heaps until the heap contains all //elements. 
Figure 11.14 shows the sequence of rebuild steps. The triangles indicate where the 
rebui I d steps are appl ied. I n the extraction step, the rebui Id step i s al ways appl ied to 
the root node. In the construction step, each rebuild step is applied successively, be¬ 
ginning with thenodeatindexL(7V - 2)/2J and ending with the node at index 0 (i.e., 
the root node). 

Now let's consider how we can implement this algorithm in Java. We must 
first decide how to represent a heap. Among the possible alternatives, an array is 
very effective in representing a heap. 
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012345678 
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Figure 11.11 One rebuild step after the value 90 is pulled out from the heap. The net result of a single 
rebuild step is a new heap that contains one fewer element. 
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No rebuild is 
necessary here. 


Figure 11.12 Eight rebuild steps to sort a heap with nine elements. 
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0 



Figure 11.13 A heap structure with given numbers assigned in ascending index order. 


Figure 11.15 shows the correspondence between the heap and the array representa¬ 
tion. An important aspect in deciding which data structure to use is the ease of 
locating a given node's left and right children. With an array implementation, we 
can locate any node's left and right children easily. A node with index 1 has its left 
child at index 2/ + 1 and its right child at index 2/ + 2. 

Sincethe heapsort algorithm is moreinvolved than theinsertion or bubblesort 
algorithm, we will put all the necessary code in a single class called Heap to provide 
a complete picture. To simplify our implementation so we can focus on the algo¬ 
rithm, we will allow only integers. You can modify the class to allow any objects to 
be sorted; see Exercise 16 at the end of this chapter. The following code illustrates 
how to use the Heap class: 

i nt [ ] number = { 9 0, 44, 8 4, 1 2, 7 7, 2 3, 3 8, 5, 1 7 }; 

i nt [ ] s o r t e d L i s t; 

Heap heap = new Heap) ); 

he ap. setData ( number ) ; //assign the original list 

sortedLi st = heap, sort ( ) ; //sort the list 

for ( i nt i = 0; i < sortedLi st. I ength; i ++) { //print out 
System, out. print!" " + sortedLi st[i]); II the sorted 

} II list 

The Heap class will include two arrays as its data members: one to implement 
a heap and another to store the sorted list. 

I * * 

* This class implements the heapsort algorithm. This class 

* can sort only integers. 

*/ 

class Heap { 
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c? 






Figure 11.14 Sequence of rebuild steps applied in the construction phase. Rebuild steps are carried out at 
index positions 3,2,1, and 0. 
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Heap 


Array implementation 


o 



012345678 
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Figure 11.15 A sample heap and the corresponding array implementation. 


/ * * * 

* Implements the heap 

*1 

private int[ ] heap; 

I * * 

* Stores the sorted list 

*/ 

private int[ ] sortedLi st; 

II methods come here 


Now let's look at the methods. The setData method initializes the two data 
members as follows: 

public void set Dat a( int [ ] data) { 

heap = new i nt [ dat a.I engt h]; 

sortedLi st = new i nt [ data.I engt h]; 

for (int i =0; i < data,length; i++) { 
h e a p [ i ] = d a t a [ i ]; 

} 


Notice that we copy the contents of the data array to the heap array. If we simply 
assign the parameter to the data member heap as 

heap = data; 

then all weare doing is setting two names referring to the same object. Since wedo 
not want to change the original data array, we make a separate copy. 
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The sort method calls two private methods that implement the two phases of 
theheapsort algorithm: 

public i nt[ ] sort) ) { 

construct) ); //perform the construction phase 
extract) ); //perform the extraction phase 
return sortedLi st; 

} 

H ere's the construct method: 

private void construct) ) { 

int current, maxChi I dl ndex; 
boolean done; 

for (int i = ( heap.Iength-2 ) / 2; i >= 0; i--) { 

current = i; 
done = false; 

while (! done) {// perform one rebuild step 
//with the node at index i 

if ( 2*current+1 > he ap,I ength-1 ) { 

//current node has no children, so stop 

done = true; 

} else { 

//current node has at least one child, 

II get the index of larger child 
maxChiI dl ndex 

= maxChi I d(current, heap. length-1); 

if (heap)current] < heap[maxChi I dl ndex]) { 

II a child is larger, so swap and continue 
swapfcurrent, maxChi I dl ndex) ; 
current = maxChi I dl ndex; 

} else { II the value relationship constraint 
II is satisfied, so stop 

done = true; 

} 

} 

} 

assert i sVaIi dHeap ( he ap, i, heap,Iength- 1 ) : 

"Error: Construction phase is not working " + 

" c o r r e c 11 y"; 
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t est Pri nt ( heap.I engt h ) ; //TEMP 


The isValidHeap method is used to assert that elements from position start to posi¬ 
tion end form a valid heap structure. Here's the method: 

private boolean i sVaIi dHeap ( int [] heap, 

int start, int end) { 

for (int i = st ar t; i < end/ 2; i ++) { 

if ( h e a p [ i ] < Ma t h. ma x ( h ea p [ 2* i +1] , he a p [ 2 * i +2 ]) ) { 

return false; 

} 


return true; 


A nd here's the extract method: 

private void extract) ) { 

int current, maxChi I dl ndex; 
boolean done; 

for (int size = heap.Iength- 1; size >= 0; size--) { 

//remove the root node data 
sortedLi st[size] = heap! 0 ]; 

//move the last node to the root 
heap! 0 ] = heap(size); 

//rebuild the heap with one fewer element 
current = 0; 
done = f alse; 

while ( ! done) { 

if ( 2 * c u r r e nt +1 > size) { 

//current node has no children, so stop 

done = true; 

} else { 

//current node has at least one child, 

II get the index of larger child 

maxChiIdl ndex = maxChiI d(current, size); 

if (heap[current] < heap[maxChi I dl ndex]) { 

II a child is larger, so swap and continue 

swap(current, maxChi I dl ndex); 
current = maxChi I dl ndex; 
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} else { //value relationship constraint 
II is satisfied, so stop 

done = true; 

} 

} 

} 

assert i sVaIi dHeap ( he ap, i, heap.Iength- 1 ) : 

"Error: Construction phase is not working " + 
" c o r r e c 11 y"; 

testPri nt( size ); //TEMP 


} 

} 

A number of methods are shared by both methods. The maxChild method 
returns the index of a node's left or right child, whichever is larger. This method 
is called only if a node has at least one child. The first parameter is the index of a 
node, and the second parameter is the index of the last node in a heap. The second 
parameter is necessary to determine whether a node has a right child. The method 
is defined as follows: 

private int maxChildfint location, int end) { 

int result, I eftChiI dl ndex, ri ghtChi I dl ndex; 

right Childlndex = 2* location + 2; 

I ef t Chi I dl ndex = 2* I ocat i on + 1; 

//Precondition: 

II Node at 'location 1 has at least one child 

assert I eftChiI dl ndex <= end: 

"Error: node at position 11 + location + 

“has no children."; 

if ( ri ght Chi Idl ndex <= end && 

heap! I eftChi Idl ndex] < heap [ ri ghtChiIdI nde x]) { 

result = ri ght Chi I dl ndex; 

} else { 

result = I eftChi I dl ndex; 

} 

return result; 

} 

The other two methods shared by the construct and extract methods are swap 
and testPrint. The swap method interchanges the contents of two array elements, 
and the testPrint method outputs the heap array for verification and debugging pur¬ 
poses. You can comment out the calls to testPrint from the construct and extract 
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methods after you verify that the algorithm is implemented correctly. Here are the 
two methods: 

private void swap ( i nt loci, i nt I o c 2 ) { 
i n t t e mp; 

temp = h e a p [ I o c 1 ]; 
h e a p [ I o c 1 ] = heap!Ioc2] ; 
heap! I oc 2] = t emp; 

} 


private void testPri nt(i nt limit) { 

for ( i nt i = 0 ; i < I i mi t; i ++) { 

System, out. print! " " + h e a p [ i ] ) ; 

} 

System, out. pri ntl n(" " ) ; 

} 

There are several improvements we can make to the simple Heap class we 
provided here. These improvements are left as Exercise 16. 

Performance 

How good is the heapsort? We mentioned in Section 11.2 that the performances of 
both selection and bubble sort algorithms are approximately 2V 2 comparisons for 
sorting 2V elements. The heapsort algorithm is substantially more complex in 
design and implementation than the other two basic sorting algorithms. Is the extra 
complexity worth our effort? The answer is yes. The performance of the heapsort 
algorithm is approximately 1.52V log 2 2V comparisons for sorting 2V elements. 
This is a remarkable improvement. Consider the difference between the two per¬ 
formances for large 2V. For example, to sort 100,000 elements, the selection or 
bubble sort requires 10,000,000,000 comparisons, while the heapsort requires only 
1.5-100,000 log 2 100,000 ~ 2,491,695 comparisons. If a single comparison takes 
1 microsecond (p,s) (one millionth second), then the selection or bubble sort takes 
about 2.8 hours while the heapsort takes only about 2.492 seconds. (Note: The 
sorting operation itself may complete in a few seconds, but printing out the sorted 
100,000 elements would take much longer.) 

L et's study how the performance of 1.52V log 2 N comparisons is derived. W hat 
we need to count is the number of comparisons made during the rebuild steps in 
both the construction and extraction phases. During the extraction phase, the rebuild 
process is carried for 2V — ltimes. If we let K be the maximum number of compar¬ 
isons required in one rebuild step, then the total number of comparisons will be 
(2V - 1 )K. In one rebuild step, we start comparing the value in the root node with 
the larger of its two children. If the value relationship constraint is not violated, the 
rebuild step terminates immediately. If there is a violation, we make a swap and 
continue. This compare-and-swap operation is carried out until either the value re¬ 
lationship constraint is met or there are no more nodes to compare. This means that 
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Figure 11.16 

level 

depth 



A sample heap with depth = 4, which is defined to be the largest level of all nodes in a heap. 


the maximum number of comparisons K is derived by finding out how many times 
the value relationship constraint violation can occur before the nodes to compare 
are exhausted. 

Consider the heap shown in Figure 11.16. We define the /a of a node in a heap 
to be the number of nodes i n the path from the root to thi s node. F or exampl e, the I evel 
of node 44 in the sample heap is 3. The of a heap is defined to be the largest 
level of the nodes in the heap. The depth of the sample heap is therefore 4. Since the 
compare-and-swap operation starting from the root can never continue comparing 
beyond the largest level of the nodes, the depth of a heap is the value we seek for K. 
Thus, the value for K is derived by finding the depth of a heap with TV elements. 

At level 1, there is one node. At level 2, there are two nodes. Since a node at 
level i can have at most 2 children, the maximum number of nodes at level / + 1 is 
double the number of nodes at level /'.Assuming the maximum number of nodes at 
all levels, the number of elements at level i is 2' “ \ so the maximum total number of 
nodes in a heap of depth K is 

V 2' -1 = 2* — 1 

i=i 

B ecause a heap must sati sfy the structural constrai nt, we know the rel ati onshi ps 

2 K ~ l - 1 < N < 2 K - 1 
2 K 1 < N + 1 < 2 K 

will hold. By applying log 2 to all terms, we have 

K- 1 < log 2 (N+1)<K 


so 


K= flog 2 (N + 1)1 

Finally, the total number of comparisons for the extraction phase is 
(N- 1 )k = n- flog 2 (W+ I)] «wlog 2 W 
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The construction phase will perform approximately N/2 rebuild steps. Each 
rebuild step will take no more than K comparisons, so the total number of compar¬ 
isons for the construction phase is 


y log 2 N 

The total number of comparisons for both phases is therefore 

1.5JVlog 2 N 


W 

Quick 

C T 


1. The following structure violates the value relationship constraints. Use the 
construction phase routine of the heapsort to eliminate the violations. 



2. Identify all violations on structural and value relationship constraints in the 
following structure. 



11.4 Sample Development 


Sorting an AddressBook 

Let's put the our basic knowledge of sorting algorithms into practice. In Chapter 10 we 
presented the AddressBook class that maintains a collection of Person objects. We will 
extend the AddressBook class by incorporating a sorting routine. The new AddressBook 
class will include a method that sorts the Person objects in alphabetical order of their 
names or in ascending order of their ages. 

Instead of going through the development steps, we will discuss three different 
implementations to illustrate various techniques of Java programming. The three classes 
are named AddressBookVerl, AddressBookVer2, and AddressBookVer3. We will 
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11.4 Sample Development— continued 


define an interface and make these three classes implement the defined interface. We 
have already dealt with interfaces,for example, the List and Map interfaces in Chapter 10. 
As we learned in that chapter, the interface defines a behavior, and if a class implements 
the interface, we can be certain that the instances of the class will support this behavior. 
Making classes implement the same interface is therefore a way to enforce consistency 
among the implementation classes. Because all three classes AddressBookVerl, 
AddressBookVer2, and AddressBook3 implement the same interface, they will exhibit 
the same behavior, and we can therefore use them interchangeably in our programs. 

The interface is named AddressBook, and we will include the public methods 
that must be supported by all versions. Collectively these public methods define the 
behavior common to all implementing classes. Public methods in the interface must not 
have any method body, only the method prototype followed by a semicolon. Here's the 
AddressBook interface: 
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The driver 

program 1 

to test the working of AddressBook is defined as follows: 



Chapter 11 Sample Program: Test program to verify the 
the AddressBook and Person classes 


File: TestAddressBookSorti ng.java 
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import javax.swing.*; 

class TestAddressBookSorti ng { 


public static void mai n(Stri ng[] 

TestAddressBookSorti ng tester 

args) { 

= new TestAddressBookSorti ng(); 

tester, s t a r t (); 

} 

private void start) 
String!) name = 

) { 

{“ape" 

“dog” 

“hen" 

"cat" 

“gnu" 

"tic" 

, "bee", "bat", 

, "yak", “fox", 

, " ma n" }; 

/- 

"eel", ^ 
" cow", 

start 


Person p; 


AddressBook ab; 

Scanner scanner = new ScannerfSystem. in); 

System, out. pri nt("Versi on #: " ); 
int version = scanner. nextlntf); 

switch (version) { 


case 

1: 

a b 

= new Addr essBookVer 1( ) 

; break 

case 

2: 

a b 

= new AddressBookVer2( ) 

; break 

case 

3: 

a b 

= new AddressBookVer3() 

; break 

default: 

a b 

= new Address BookVer 1( ) 

; break 

( i nt 

i = 

0: 

i < na me. 1 e ng t h; i ++) { 


P = 

new 

Person!name [ i ] , random)10, 

50), 




r a n d o m( 0, 1 ) ==0? ' M' : 

1 F' ) ; 


II note: random( 0, 1) == 0 ? ' M' : ' F' 

II means if (random! 0,1) == 0) then ' M' else ' F 1 
a b. a d d ( p ) ; 

} 

Person!) sortedlist = ab.sort ( Person.AGE ) ; 

for (int i = 0; i < sortedli st.I ength; i ++) { 

System, out. pri ntl n( sortedli st[i J.toStri ng( )); 

} 

System, out. pri ntl n(" "); 

sortedlist = ab. sort ( Person. NAME) ; 

for (int i = 0; i < sortedlist.I ength; i ++) { 

System, out. pri ntl n( sortedli st[i J.toStri ng( )); 

} 
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/ 



random 


private i nt random! i nt low, i nt high) { 

return (int) Math, floor! Math, random! ) 
+ I ow; 


high - low + 1)) 


Version 1 


In describing the basic sorting algorithms, we limit the data values to integers. This makes 
the comparison test easy. We write something like this: 

if ( n u mb e r [ i ] < n u mb e r [ i +1 ]) { 

II do s omet hi ng. . . 

} else { 

II do so me thing else... 

} 

But how do we compare Person objects? We cannot say 

Person pi = new Person! “jack", 18, ' M' ) ; 

Person p2 = new Person! "Jill", 19, ' F' ) ; 


Cannot compare Person objects like this, because 
it does not make sense.Comparison operators 
other than equal (==) do not apply for objects. 


if (pi < p 2) { 


because the comparison operators such as <, >, and others except the equal operator 
are meaningful only for comparing primitive data values.To be able to compare Person 
objects, we need to modify the class. Let's suppose that we want to compare two 
Person objects based on either their names or their ages. First we add the following 
two constants to the Person class of Chapter 10: 

class Person { 


public static final int NAME = 0; 
public static final int AGE = 1; 


Next we add a variable to the Person class to set which attribute to use in comparing two 
objects: 

private static int compar e Att r i bu t e = NAME; 

Notice that the variable is a class variable because this information is not specific to any 
individual Person objects, but applies to the whole class. We initialize it to NAME so the 
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Person objects will be compared on the name attribute as a default. We define a class 
method to let the programmer set the comparison attribute. The class method is defined as 

public static void setCompareAttri bute(i nt attribute) { 

compareAt tribute = attribute; 

} 

Although it is not a syntax error to initialize a class variable inside a constructor, it is 
a logical error to do so. You cannot define a constructor that includes an initialization of 

the compareAttribute variable, as in 

public Person! ) { 

c ompa r eAt t r i b ut e = NAME; 

} 

This definition is valid because the class variables can be accessed from the instance meth¬ 
ods, but it is wrong to do so here. This constructor will set the class variable com¬ 
pareAttribute that is shared by all instances of the Person class every time a new Person 
object is created.This is not what we want. We need to initialize it exactly once when the 
class is loaded into the memory. One way to do this is to initialize at the point the class vari- 
static block able is declared as shown, or to use the static block we introduced in Chapter 7. Here's how: 

class Person { 
static { 

compareAttri bute = NAME; 

} 

} 

The rule to remember is never to initialize the class variables in the constructor. 


Use the static 
block to initialize 
class variables. 


Idlings to Remember 



Do not initialize class variables in the constructor. Initialize the class variables in the 
static block. 


Now we are ready to add a method compareTo that will compare the designated 
Person objects' names or ages and return the comparison result. The method is used 
like this: 

//Persons pi and p2 are defined and created already 

//First set the comparison attribute to NAME 
Person. setCompareAttri bute(Person. NAME); 
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int compari sonResul t = pl.compareTo(p2); 

if (compari sonResul t < 0) { 

II pi's name is lexicographically less than p 2' s 

} else if ( compar i sonResul t == 0) { 

II pi's name is equal to p 2' s name 

} else { //compari sonResul t > 0 

II pi's name is lexicographically larger than p 2 1 

} 

To compare two Person objects on their ages, we write 

//Persons pi and p2 are defined and created already 

//First set the comparison attribute to AGE 
Person. setCompareAttrl bute(Person.AGE); 

int compari sonResul t = pl.compareTo(p2); 

if (compari sonResul t < 0) { 

//pi is younger than p2 

} else if ( compar i sonResul t == 0) { 

//pi's age is the same as p2 1 s age 

} else { //compari sonResul t > 0 
II pi is older than p2 

} 

Here's the compareTo method: 

public int compareTo( Person person) { 

int comparisonResult; 

if (compareAttri bute == AGE) { 
i nt p2age = per son, get Age ( ); 

if (this. age < p2age ) { 
comparisonResult = LESS; 

} else if (this, age == p2age ) { 
comparisonResult = E QUAL; 

} else { 

assert this. age > p2age; 
c o mpa r i s on Res uI t = MORE; 

} 


na me 


s na me 
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} else { //compare names with String's compareTo 

String p 2 n a me = person, getNa me ( ); 

compari sonResul t = thi s. name. compareTo(p2name) ; 

} 

return comparisonResult; 

} 

The constants LESS, EQUAL, and MORE are defined in the Person class as 


pr 

vat e 

static 

i nt 

LESS = 

- 1; 

pr 

vat e 

static 

i nt 

EQUAL = 

0: 

pr 

vat e 

static 

i nt 

MORE = 

1: 


The compareTo method of the String class behaves just as our compareTo method 
does. Indeed, our compareTo method is modeled after the String class's compareTo 
method. The wrapper classes Integer, Float, Double, and others also define the analo¬ 
gous compareTo method. Having consistent naming and behavior for comparing 
two objects of the same class allows the implementation of a more general code. See 
Exercise 16 at the end of the chapter. 

Here's the complete Person class: 



/* 


Chapter 11 Sample Program: Person class 
File: Person.java 

*1 

class Person { 


publ i c 

static f 

i na 1 

i nt 

NAME = 

0; 

publ i c 

static f 

i na 1 

i nt 

AGE = 1 

I 

privat e 

st at i c 

final 

i nt 

LESS = 

- 1; 

privat e 

st at i c 

final 

i nt 

EQUAL 

= 0; 

privat e 

st at i c 

final 

i nt 

MORE 

= l; 

privat e 

st at i c 

int compareAttri 

but e 

private 

St ri ng 

n a me 




privat e 

i nt 

age; 




private 

char 

gender; 



St a t i 

c i n i t i a 

1 i z e r 




st at i c 

{ 





c o mp a r e At t r i 

} 

but e 

= NAME; 


public 

Person!) 

{ 





this( "Not Given", 0, 1 U 1 ) ; 

} 


/ \ 

Data members 


Constructors 
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11.4 Sample Development— continued 


public Person(String name, int age, char gender) { 
t his. age = age; 

this, na me = name; 

t his. gender = gender; 


public static void setCompareAttri bute(i nt attribute) 
compareAttri bute = attribute; 

} 

public int compareTo( Person person, int attribute) { 
int compari sonResul t; 

if (attribute == AGE) { 

int p 2 a g e = person. getAge( ); 


{ 



if (this. age < p2age ) { 

compari sonResul t = LESS; 

} else if (this. age == p2age ) { 
compari sonResul t = EQUAL; 

} else { 

assert this. age > p2age; 
compari sonResul t = MORE; 

} 


} else { //compare the name using the String class's 
//compareTo method 

String p 2 n a me = person.getName ( ); 
compari sonResul t = thi s. name. compareTo( p2name) ; 


return comparisonResult; 

} 

public int compareTo(Person person) { 

return compareTo( person, compareAttri bute); 

} 


publ i c i nt get Age ( ) { 
return age; 

} 

public char get Gender) ) { 
return gender; 

} 


public String getNa me ( ) { 
return n a me; 

} 


Accessors 
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public void setAge(int age) { 
this. age = age; 

} 

public void setGender(char gender) { 
t his. gender = gender; 

} 

public void setNa me (String name) { 
this, na me = name; 

} 

public String toStringl ) { 

return t h i s. n a me + " \ t \ t" + 

t h i s. a g e + " \ t \ t " + 

this. gender; 

} 

} 


Mutators 


toString 


Now we are ready to add a sorting routine to the AddressBook class. The sort 
method accepts one integer parameter that specifies the attribute to compare in sorting 
the Person objects.The method returns an array of Person objects sorted on the desig¬ 
nated attribute. We use the bubble sort algorithm for the method. Using the heapsort 
algorithm is left as Exercise 17. Here's the sort method. 

public Person! ] sortjint attribute) { 

Person! ] sortedLi st = new Person [ count ] ; 

Person pi, p2, temp; 

II copy references to sortedLi st; see Figure 11.17 
for (int i =0; i < count; i++) { 
sortedLi st[i ] = ent r y[ i ] ; 

} 

II Set the comparison attribute 
Person. setCompareAttri b ut e ( a11 ri bute); 

//begin the bubble sort on sortedLi st 
int bottom, compari sonResul t; 

boolean exchanged = true; 

bottom = sortedLi st. I ength - 2; 

while (exchanged) { 

exchanged = false; 

for ( i nt i =0; i <= bot t om; i ++) { 
pi = sortedLi st[i ]; 
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11.4 Sample Development— continued 


p2 = sortedLi st[i +1]; 

compari sonResult = pl.compareTo(p2, attribute); 


if (compari sonResul t 
sortedLi st[i] 
sortedLi st[i +1] = 


> 0) { //pi is 'larger 
p2; II than p2, so 

pi; //exchange 


exchanged = true; //exchange is made 

} 

} 

bottom--; 

} 

return sortedLi st; 


The sort method first creates a temporary array called sortedList and copies 
the references from the entry array into this sortedList. We do this so we can sort the 
objects on a specified attribute without affecting the order maintained in the entry array. 
Figure 11.17 illustrates how this sortedList array is used in sorting the Person objects on 
the age attribute. 

Here's the AddressBookVerl class: 


Chapter 11 Sample Program: Address Book Version 1 
File: AddressBookVerl.java 

*1 

class AddressBookVerl implements AddressBook { 

private static final int DEFAULT_SIZE = 25; 
private static final i nt N OT _ F OU N D = -1; 

private Person!] entry; 
private int count; 

public Addr ess BookVer 1( ){ 
t hi s( DEFAULT SIZE); 

} 


Data members 


( \ 

Constructors 


public AddressBookVer 1( i nt size){ 
count =0; 

if (size <= 0) { //invalid data value, use default 
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entry 



Before sorting 
on age. 


The values are the age of 
Person objects. 


0 12 3 


entry 


After sorting 



I The sort method returns 
| this array. 


0 12 3 


Figure 11.17 The diagram illustrates how the separate array is used in sorting. Notice that the original 
array is unaffected by the sorting. 


throw new I I I egal ArgumentExcepti on(" Size must be positive"); 

} 


entry = new Person[si ze]; 


II System, out. p r i n 11 n ( " array of "+ size + " is created.”); II TEMP 

} 


public void add( Person newPerson) 

if (count == entry. length) { 
expand) ); 

} 


{ 

II no mor e space left, 

II create a new larger array 
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11.4 Sample Development— continued 


II at this point, entry refers to a new larger array 
e nt r y [ c o u nt ] = newPerson; 
c o u nt ++; 

} 

public boolean del ete(Stri ng searchName) { 

boolean status; 

i nt I oc; 



loc = findlndex(searchName); 


if (loc == NOT_FOUND) { 
status = false; 

} else { //found, pack the hole 


ent r y [ I oc ] = ent r y [ count■ 1] ; 
status = true; 

count--; //decrement count, 

//since we now have one fewer element 

} 

return status; 

} 

public Person search(String searchName) { search 

Person foundPerson; 
i nt I oc = 0; 


whi I e (loc < count && 

!searchName. equal s (e n t r y [ I oc] , get N a me ( ) )) 
I oc ++; 

} 

if (loc == count ) { 

foundPerson = null; 

} else { 

foundPerson = e nt r y [I oc ] ; 

} 

return foundPerson; 


public Person! ] sort(int attribute) { 

Person! ] sortedLi st = new Person [ count ] ; 
Person pi, p2, temp; 


( -\ 

sort 
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//copy references to sortedLi st 

for ( i nt i =0; i < count; i ++) { 
sortedLi st[i ] = ent r y [i]; 

} 

II set the comparison attribute 
entry[0] . setCompareAttri butefattri bute); 

//begin the bubble sort on sortedLi st 
int bottom, compari sonResul t; 

boolean exchanged = true; 

bottom = sortedLi st.I ength - 2; 

while (exchanged) { 

exchanged = false; 

for ( i nt i =0; i <= bot t om; i ++) { 
pi = sortedLi st[i ]; 
p2 = sortedLi st[i +1]; 

II compari sonResul t = pl.compareTof p 2, attribute ); 

compari sonResul t = pl.compareTo(p2); 

if (compari sonResul t > 0) { II pi is ’larger' 

II than p2, so 

sortedLi st[i] = p2; //exchange 

sortedLi st[i +1] = pi; 

exchanged = true; //exchange is made 

} 

} 

bottom--; 

} 

return sortedLi st; 

} 

private void expand) ) { expand 

II create a new array whose size is 150% of 
II the current array 

int newLength = (int) (1.5 * e n t r y. I e n g t h ) ; 

Person[] temp = new Person [ newLength ]; 

II now copy the data to the new array 
for (int i = 0; i < ent r y. I engt h; i ++) { 
t e mp [ i ] = e n t r y [ i ] ; 

} 

//finally set the variable entry to point to the new array 
entry = t e mp; 
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11.4 Sample Development— continued 


II System, out. p r i n 11 n ( “ Inside the method enlarge”); //TEMP 

II System, out.printlnf" Size of a new array: " + entry.length); //TEMP 

} 


private int findlndex(String searchName) { 
i nt I oc = 0; 

while ( I oc < count && 

! searchName. equal s(entry[l oc] . getNamef) ) ) { 
I oc ++; 

} 

if (I oc == count ) { 

I oc = N0T_ FOUND; 


( \ 

findlndex 


} 


} 

return I oc; 


Version 2 

In the second implementation of the AddressBook interface, we will use the sorting 
routine provided in the java.util.Arrays class, which includes a number of useful 
methods for handling arrays. To use the sort method of the Arrays class, we must pass 
a comparator object as its second argument. A comparator object is an instance of a 
class that implements the Comparator interface. In the first version, we relied on the 
comparison routines embedded in the Person class. We are thus limited to what's 
provided by the Person class, namely, sorting by name or sorting by age. We cannot, 
for example, sort on gender and then within the same gender sort on age. By provid¬ 
ing an implementation class of the Comparator interface, we can sort Person objects 
(or any other types of objects) in any manner we want. 

To implement the Comparator interface, we must implement its compare 
method. The function of the compare method is similar to that of the compareTo 
method in the Person class. Any class that implements the Comparator inter¬ 
face must specify the type of the objects it will compare. For this example, the class 
compares Person objects, so the class will implement Comparator<Person>. The 
parameters for the compare method must match the specified type, which in this 
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inner class 


case is Person. Here's the comparator class that compares two Person objects based 
on their age: 


class 

Age 

Comp 

a r a t o r i mp 1 e me n 

ts Comp 

pr 1 

vat 

e f 1 

nal int LESS = 

- 1; 

pri 

vat 

e f i 

nal int EQUAL = 

0; 

pri 

vat 

e f 1 

nal i nt MORE = 

1; 

pub 

1 1 c 

i nt 

c o mp a r e ( P e r s o n 

pi, Pe 


i nt 

compari sonResul t; 



i nt 

p 1 a 

ge = pi.get Age ( 

) ; 


1 nt 

p 2 a 

ge = p2,get Age ( 

); 


i f 

( pla 

ge < p2age ) { 




c omp 

ari sonResul t = 

LESS; 


} e 

1 se 

if (plage == p2 

age) { 



c omp 

ari sonResul t = 

EQUAL; 


} e 

1 se 

{ 




asse 

rt plage > p2ag 

e; 



c omp 

ari sonResul t = 

MORE; 


} 





ret 

u r n 

compari sonResul 

t; 


} 

} 


The NameComparator is similarly defined. The AgeComparator and Name- 
Comparator classes are helper classes specific to the AddressBookVer2 class, and as 
such, it is appropriate to define them as the inner classes of AddressBookVer2. An inner 
class is a class whose definition is given within the definition of another class, as in 


class Outer { 


class Inner { 

} //end of Inner 
} //end of Outer 

We can prefix the inner class definition with the visibility modifier public or private. The 
public modifier will make the inner class accessible to the client classes outside of the 
package while the private modifier will make the inner class inaccessible to all other 
classes Just as the ordinary class definitions class definition without a visibility modifier 
is accessible to all other classes within the same package (classes in the same directory 
are in the same package). 
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11.4 Sample Development— continued 


As for the actual sorting task, we will use the sort method of the Arrays class 
instead of writing our own sorting algorithm. The sort method of the AddressBookVer2 
class is now defined as follows: 

public Person! ] sortfint attribute) { 

if (!( at t ri but e == Person. NAME || 
attribute == Person. AGE)) { 
throw new I I I egal ArgumentExcepti on( ); 

} 

Person! ] sortedList = new Person [ count ] ; 

II copy references to sortedList 
for ( i nt i =0; i < count; i ++) { 
sortedLi st[i ] = e nt r y [i ]; 

} 

Arrays. sort! sortedLi st, getComparator( attri b u t e )) ; 
return sortedList; 

} 

And the private getComparator method is defined as follows: 

private Comparator<String> getComparator! int attribute) { 
Comparat or <St r i ng> comp = null; 

if (attribute == Person. AGE) { 
comp = new AgeComparator! ); 

} else { 

assert attribute == Person.NAME: 

"Attribute not recognized for sorting"; 

comp = new Name Comparator! ); 

} 

return c o mp; 

} 

The first argument to the sort method of the Arrays class is an array of objects we 
want to sort, and the second argument is the comparator to use in comparing array 
elements. For example, if we want to sort the Person objects by gender first and in de¬ 
scending order of age within the same gender, we can define the comparator as 

class GenAgeComparator implements Comparator<Person> { 

private final i nt LESS = - 1; 
private final int EQUAL = 0; 
private final i nt MORE = 1; 


Sorts the list by 
using the given 
comparator 
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public int compare! Person pi, Person p2 ) { 
int comparisonResult; 

int plage = pi,get Age( ); 
int p2age = p2. getAge( ); 

char plgender = pi.get Gender (); 
char p2gender = p 2.get Gender (); 


Notice that we are switching 
the positions of pi and p2 
because we are sorting in 
descending order. 


} 


if (plgender < p2gender) { 
comparisonResult = LESS; 

} else if (plgender == p2gender) { 
if ( p2age < plage) { 

comparisonResult = LESS; 

} else if ( p2age == plage) { 
comparisonResult = E QUAL; 

} else { 

assert p 2 a g e > plage; 
c o mpa r i s on Res uIt = MORE; 

} 

} else { 

assert plgender > p2gender; 
comparisonResult = MORE; 

} 

return comparisonResult; 


and we can call the sort method as 


Arrays. sort ( sorted L i st, new GenAgeComparat or ()) ; 

Here's the AddressBook2 class (only the modified portions are shown): 



Chapter 11 Sample Program: Address Book Version 2 
File: AddressBookVer2.j ava 


import java.util.*; 


class Addr essBookVer 2 implements AddressBook { 


public AddressBookVer2( ) { 
this) DEFAULT SIZE ); 

} 
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11.4 Sample Development— continued 


public Add r e ss Boo k Ve r 2 ( i nt size) { 

} 


public Person) ] sort) int attribute) { 

if (! (attri bute == Person.NAME || attribute == Person. AGE)) 
throw new I I I egal ArgumentExcepti on( ); 

} 

Person) ] sortedList = new Person [ count ]; 

II copy references to sortedList 
for (int i =0; i < count; i++) { 
sortedLi st[i ] = e nt r y [i ]; 

} 

Arrays. sortfsortedLi st, getComparator(attri bute)); 
return sortedList; 


} 


private Comparat or <Str i ng> getComparat or ( i nt attribute) { 
Comparator <S tr i ng > comp = null; 

if (attribute == Person,AGE) { 
comp = new AgeComparat or ( ); 

} else { 

assert attribute == Person,NAME: 

"Attribute not recognized for sorting"; 

comp = new Name Comparator) ); 

} 

return c o mp; 


/ / I nner Cl asses 

//Inner class for comparing age 

class AgeComparator implements Comparator<Person> { 

private final int LESS = -1; 
private final int EQUAL = 0; 
private fi nal i nt MORE = 1; 
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} 


public 

int compare! Person pi, Person p 2 ) { 

i nt 

compari sonResult; 


i nt 

plage = pi,get Age 

( ); 

i nt 

p2age = p2.get Age 

( ); 

if ( 

plage < p2age ) { 



compari sonResult 

= LESS; 

} el 

se if (plage == p 

2 a g e ) { 


compari sonResult 

= EQUAL; 

} el 

se { 



assert plage > p2 

age; 


compari sonResul t 

= MORE; 

} 



r et u 

rn compari sonResu 

1 t; 

} 



} 



//Inner cl 

ass for c o mp a r i n g 

na me 

class N a me 

Comparator implements Comparator<String> 

public 

int compare( Person pi, Person p2 ) { 

String plname = pi. 

g e t N a me ( ); 

String p2name = p 2. 

g e t N a me ( ); 

return plname. compareTo( p2name); 


} 

} 


{ 


While the main purpose of the AddressBookVerl class is pedagogy, the 
AddressBookVer2 class, with its use of the efficient Arrays class sort method based on a 
high-performance sorting technique called merge sort and the generality provided by the 
Comparator interface, is closer to what we would really use in practice.The last version, 
AddressBookVer3, would improve further by using the map from the Java Collection 
Framework.This eliminates the code to maintain the array in our class. 

Version 3 

The third implementation of the AddressBook interface eliminates the use of an array 
altogether. Instead of maintaining the array of Person objects ourselves, we will rely on 
the service provided by the Map interface from the java.util package. 

The key for the map is the person's name, and the value is the Person object.The 
add, delete, and search methods now all just make calls to the map's methods for data 
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11.4 Sample Development— continued 


management.The sort method retrieves a collection of values in the map, converts this 
collection to an array, and then passes this array to the sort method of the Arrays class. 
Here's how we define the sort method: 

public Person! ] s o r t ( i n t attribute) { 

if (!( at t ri but e == Person, NAME || 
attribute == Person.AGE) ) { 
throw new I I I egal ArgumentExcepti on( ); 

} 

Person! ] sortedLi st = new Person[entry. si ze()]; 
entry, val ues(). toArrayfsortedLi st); 

Arrays. sort! sortedLi st, getComparator( attri b u t e )) ; 

return sortedLi st; 

} 

Here's the AddressBookVer3 class: 


Chapter 11 Sample Program: Address Book Version 3 
File: AddressBookVer3.j ava 

*/ 

import java.util.*; 

class Addr essBookVer 3 implements AddressBook { 

private static final i nt DEFAULTSIZE = 25; 

private Map<String, Person> entry; 

public Addr essBookVer 3( ) { 
thi s( DEFAULT SI ZE); 

} 

public Add r ess Boo k Ve r3 ( int size) { 

entry = new HashMap <S tri ng, Person> (size); 

} 

public void add( Person newPerson) { 

ent ry. put ( newPerson. get Name( ) , newPerson); 

} 

public boolean del ete(Stri ng searchName) { 
boolean status; 

Person p = entry. remove(searchName); 


' > 

Data members 


( 

Constructors 

^J 


r 

add 






delete 

\ 
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if ( p == nulI ) { 
status = false; 
} else { 

status = true; 

} 


return status; 

} 

public Person search(String searchName) { 
return entry. get(searchName); 

} 

public Person! ] sortfint attribute) { 

if (! (attri bute == Person.NAME || attribute 
throw new I I I egal ArgumentExcepti on( ); 

} 


search 


sort 


Person.AGE) ) { 


Person! ] sortedLi st = new Person[entry. si ze( )] ; 
entry.v a I ues().toArray(sortedLi st); 

Arrays, sort (sortedLi st, getComparator(attri bute)); 

return sortedLi st; 

} 


} 


Summary 


Searching and sorting are two of the most basic nonnumeric applications of 
computer programs. 

Linear search looks for a value in a linear sequence. 

Binary search looks for a value by successively comparing the element in 
the middle of a sorted list. 

Selection sort is a basic sorting routine that runs in time proportion to N 2 , 
where N is the size of the list to sort. 

Bubble sort is another N 2 performance algorithm, but it runs faster than 
the selection sort on average. 

Heapsort has a N log 2 /V performance. It uses a special heap data structure 
to sort the elements. 
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Sorting and Searching 


Using a class that implements the Comparator interface is convenient and 
flexible to dictate the manner in which objects of a class are compared. 

The Comparator interface has one method, called compare. 

The standard classes and interfaces described or used in this chapter are 

Comparator Arrays 


Key Concepts 

linear search 


heapsort 

binary search 


N 2 sorting algorithm 

selection sort 


?Vlog 2 Wsorting algorithm 

bubble sort 


comparator 

Chapter 11 Exei 

' c i s e s 



Review Exercises 

1. Consider the following array of sorted integers: 


0123456789 10 11 


10 

15 

25 

30 

33 

34 

46 

55 

78 

84 

96 

99 


Using the binary search algorithm, search for 23. Show the sequence of array 
elements that are compared, and for each comparison, indicate the values for 
low and high. 

2. We assumed all elements in an array are distinct; that is, there are no 
duplicate values in the array. Whatwill bean effect on the I inear search 
algorithm if an array contains duplicate values? 

3. Will the sorting algorithms presented in this chapter work if the unsorted 
array contains any duplicate values? 

4. In this chapter we analyzed sorting algorithms by counting the number of 
comparisons. A nother possible method for analyzing the algorithms is to 
count the number of data exchanges. How many data exchanges do the 
selection and bubble sort make in the worst case? Regardless of the original 
list, the selection sort will make the same number of data exchanges. 
However, the number of data exchanges the bubble sort makes depends on 
the arrangement of elements in the original list. 

5. Analyze the insertion sort algorithm of Exercise 10 by counting the 
number of comparisons and data exchanges. Provide the analysis for the 
worst case. 
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Level 1 Programming Exercises ★ 

& M odify the selection sort algorithm to sort string data. Write a test program 
to verify the correct implementation. 

7. M odify the bubble sort algorithm to sort string data. Write a test program to 
verify the correct implementation. 

a Write a program that input N words (string) and output them in alphabetical 
order. Use the sorting algorithm from Exercise 6 or Exercise 7. 


Level 2 Programming Exercises ★★ 

9. We started discussing sorting algorithms in Section 11.2 by presenting a 
basic sorting algorithm suitable for a human. We stated that the operation 
of crossing the numbers out for further consideration is effective for a 
human but not for a computer program. This is true when we are using 
an array. If we use a LinkedList (an ArrayList won't really work here 
because an array is used to implement an ArrayList) for the original 
(unsorted) list, then wecan implement the action of crossing outa 
number and moving it to a sorted list effectively. LetoriginalUst be a 
LinkedList. To remove an item of originalList at index position I, we 
write 


originalList. re mo v e ( I ) ; 

This will actually remove the item from the list, not just marking it as 
removed, as is the case with an array. Write a program that implements this 
algorithm. Include a suitable input and output routines. You may restrict the 
data to integers only. 

10 l Another simple sorting algorithm is called an insertion sort. Suppose we 
have a sorted Iist of N elements and we need to insert a new elements into 
this list to createasorted list of Af + 1 elements. Wecan inserts at the correct 
position in the list by comparing it with elements \\st[N - 1], list[7V - 2], 
list [N - 3], and so forth. Every time we compared and list[i], we shift 
I i st[ i ] one position to I i st[ i + 1] if X is smaller than I i st[ i ]. When we find 
list[i] that is smaller than X, weputx at position i + 1 and stop. We 
can apply this logic to sort an unordered list of N elements. We start with a 
sorted list of one element and insert the second element to create a sorted 
list of two elements. Then we add the third element to create a sorted list of 
three elements. Figure 11.18 illustrates the steps in the insertion sort. Write 
a program that implements the insertion sort algorithm. You may simplify 
the method by sorting only integers. 

IL W rite a test program to compare the performances of selection sort, 
bubble sort, and heapsort algorithms experimentally. Randomly generate 
5000 integers, and sort the generated integers by using the three sorting 
algorithms. For each execution, record the time it took to sort the numbers. 
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Sorted 


U nsorted 



012345678 


23 

17 

5 

90 

12 

44 

38 

84 

77 


rj 

Insert 17 
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1 



3 

4 

5 

6 

7 

8 

© 

17 

23 

5 

90 

12 

44 

38 

84 

77 

M 

t_ 









0 


Insert 5 
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3 

4 

5 

6 

7 

8 

© 

5 

17 

23 

90 

12 

44 

38 

84 

77 



t_ 

Insert 90 


and so on... 


Figure 11.18 Steps in an insertion sort. 


You can use the java.util.Date class to record the execution time in 
milliseconds, for example, 

Date s t a r t T i me, e n d T i me; 

s t a r t T i me = new D a t e (); 

II sort the integers 

e n d T i me = new D a t e () ; 

II record the elapsed time 

doubl e el apsedTi me 

= endTi me. getTi me() - startTi me. getTi me(); 

32 . In the Heap class, we used two separate arrays: one for the heap and another 
for the sorted list. It turns out we can do everything with just one array. 
Notice that the heap will decrease in size by one element after every rebuild 
step. The unused space at the end of the heap array can be used to store the 
sorted list. M odify the Heap class so it will use only one array. 
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33. M odify the Heap class by defining a separate method called rebuild, which 
will be used by both the construct and extract methods. 

Level 3 Programming Exercises ★★★ 

14 Consider the following property about the bubble sort: 

If the last exchange made in some pass occurs at the Jth and 
(J + l)st positions, then all elements from the (J + l)st to the Nth 
positions are in their correct location. 

Improve the bubble sort algorithm by incorporating this property. Writea 
test program to verify the correct implementation of the modified bubble sort 
algorithm. 

35. Consider another property about the bubble sort: 

If the first exchange made in some pass occurs at the Ith and 
(I + l)st positions, then all elements from the 1st to (I — l)st 
positions are in ascending order. 

Improve the bubble sort algorithm by incorporating this property. Write a test 
program to verify the correct implementation of the modified bubble sort 
algorithm. 

16 . The Heap class given in Section 11.3 sorts only the integers. Improve the 
class by making it possible to sort any objects that recognize thecompareTo 
method, which is described in Section 11.4, so the new Heap class will be 
able to sort Person, integer, Double, and string objects among others. Since 
the elements in the internal array can be any object, declare an array of 
object objects. All Java classes are automatically a subclass of object, 
unless they are declared explicitly as a subclass of another class. The 
declaration of heap will be like this 

private Obj ect [ ] heap; 

and thesetData method will be like this: 

publ i c voi d set Da ta( Object! ] data) { 

heap = new Obj e c t [ d a t a. I ength]; 

s o r t e d L i s t = new Obj e c t [ d a t a. I ength]; 

for ( i nt i = 0; i < data.length; i ++) { 

hea p [ i ] = da t a [i ]; 

} 

} 

17 . In Section 11.4, we implemented the sorting routine for the AddressBook 
class with the bubble sort algorithm. Modify the sorting routine by using the 
Heap class of Exercise 16. 

3S. Instead of maintaining an unsorted list and returning the sorted list when the 
sort method is called, modify the AddressBook class so that it maintains the 
sorted list of Person in alphabetical order. Modify the search routine by using 
the binary search algorithm. 
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Objectives 


After you have read and studied this chapter,you 
should be able to 

• Include a JFileChooser object in your program 
to let the user specify a file. 

• Write bytes to a file and read them back from 
the file, using FileOutputStream and 
FilelnputStream. 

• Write values of primitive data types to a file 
and read them back from the file, using 

DataOutput Stream and DatalnputStream. 

• Write text data to a file and read them back 
from the file, using PrintWriter and 
BufferedReader. 

• Read a text file using Scanner. 

• Write objects to a file and read them back from 
the file, using ObjectOutputStream and 
ObjectlnputStream. 
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wW 

hat is the most important action you should never forget to take while develop¬ 
ing programs or writing documents? Saving the data, of course! It's 3 a.m., and 
you're in the home stretch, applying the finishing touches to the term paper due 
at 9 a.m. Just as you are ready to select the Print command for the final copy, it 
happens. The software freezes and it won't respond to your commands anymore. 
Y ou forgot to turn on the A utosave feature, and you have not saved the data for the 
last hour. There's nothing you can do but reboot the computer. 

Data not saved will be lost, and if we ever want to work on the data again, 
we must save the data to a file. We call the action of saving, or writing, data to a file 
file output file output and the action of reading data from a file file inp ;.A program we develop 

and input must SU pp 0 rt some form of file input and output capabilities for it to have practical 

uses. Suppose we develop a program that keeps track of bicycles owned by the 
dorm students. The program will allow the user to add, delete, and modify the bicy¬ 
cle information. If the program does not support the file input and output features, 
every time the program is started, the user must reenter the data. 

In this chapter, we will introduce the classes from the java.io and javax.swing 
packages that are used for file input and output operations. A Iso, we will show how 
the two helper classes from Chapters 8 and 9— Dorm and FileManager—that pro¬ 
vided the file input and output support are implemented. 

12.1 File and JFileChooser Objects 

In this section we introduce two key objects for reading data from or writing data to 
a file. W e use the term/F/e access to refer to both read and write operations. If we need 
to be precise, we write read access or write access. (We use the terms save and write 
interchangeably to refer to file output, but we do not say save access.) Suppose we 
want to read the contents of a file sample.data. Before we can start reading data 
File from this file, we must first create a File object (from the java.io package) and asso¬ 

ciate it to the file. We do so by calling a File constructor: 

File inFile = new File) "sample. data"); 

The argument to the constructor designates the name of the file to access. The sys- 
current tern assumes the file is located in the current directory. For the following examples, 

directory we assume the di rectory structure shown in Figure 12.1, with Chi2 being the current 

directory. When you run a program whose source file is located in directory x, then 
the current directory is x. Please refer to Java compiler manuals for other options 
for designating the current directory. 

It is also possible to open a file that is stored in a directory other than the 
current directory by providing a path name and a filename. Assuming there's a file 
xyz.data in the JavaPrograms directory, we can open it by executing 

File inFile = new FiI e("C:\\J avaPrograms", "xyz.data"): 
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C: drive 



Current directory 


Figure 12.1 Directory structure used for the examples in this section. We assume the Windows environment. 


This style of designating the path name is for the Windows platform. The actual 
path name we want to specify is 

C: \ J avaPrograms 

but the backslash character is an escape character. So to specify the backslash char¬ 
acter itself, we must use double backslashes. For the UNIX platform, we use the 
forward slash for a delimiter, for example, 

"/ J avaPrograms" 

For the M ac platform, we also use a forward slash; for example, if the name of a 
hard disk is MacHD, then we write 

"/ MacHD/J avaPrograms" 

To maintain the consistency across the platforms, the forward slash character is 
allowed for the Windows platform also, such as in 

"C:/JavaPrograms/Chl2" 

The path name could be absolute or relative to the current directory. The 
absolute path name is the full path name beginning with the disk drive name, for 
example, 

" C: / J avaPrograms/Chl2" 

The relative path name is relative to the current directory. For example, if the cur¬ 
rent directory is chi 2 , then the relative path name 

" . . / C h 12 " 


www.it-ebooks.info 



















688 Chapter 12 File Input and Output 


is equivalent to the full path name 

"C:/J avaPrograms/ Chl2" 

where the two dots (..) in the string mean “one directory above.” 

We can check if a File object is associated correctly to an existing file by call¬ 
ing its exists method: 

if (inFile,exists! )) { 

II inFile is associated correctly to an existing file 

} else { 

II inFile is not associated to any existing file 

} 

When a valid association is established, we say the file is opened; a file must 
be opened before we can do any input and output to the file. 


LJilings to Remember 

A file must be opened before we can execute any file access operations. 



A File object can also be associated to a directory. For example, suppose we 
are interested in listing the content of directory Chi 2. We can first create a File object 
and associate it to the directory. After the association is made, we can list the con¬ 
tents of the directory by calling the object's list method: 

File directory = new Fi I e("C:/JavaPrograms/Chl2"); 

String filename!] = directory. Iist(); 

for ( i nt i = 0; i < fi I ename. I ength; i ++) { 

System, out. pri ntl n(fi I e n a me [ i ] ); 

} 

We check whether a File object is associated to a file or a directory by calling 
its boolean method isFile. The following code will printout I am a directory: 

File file = new File("C:/JavaPrograms/Chl2"); 

if (file.isFile!)) { 

System, out, pri ntl n ( " I am a file"); 

} else { 

System, out. pri ntl n ( " I am a directory"); 

} 
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Figure 12.2 A sample JFileChooser object displayed with the showOpenDialog method. The dialog title 
and the okay button are labeled Open. 


We can use a javax.swing.JFileChooser object to let the user select a file. 
The following statement displays an open file dialog, such as the one shown in 
Figure 12.2 (the actual listing depends on the machine on which the program is 
executed): 

JFileChooser chooser = new JFileChooser! ); 
chooser. showOpenDi al og ( nuI I ); 

The null argument to the showOpenDialog indicates that there's no parent frame 
w i ndow, and the di al og i s di spl ayed at the center of the screen. We pass a f rame w i n- 
dow object if we want to position the file dialog at the center of the frame. A frame 
window is discussed in Chapter 14. In this chapter, we use a null for the argument. 

When we create an instance of JFileChooser by passing no arguments to the 
constructor, as in this example, it will list the content of the user's home directory. 
For the Windows platform, the user's home directory by default is the My Docu¬ 
ments folder. We can set the file chooser to list the contents of a desired directory 
when it first appears on the screen. We can do this in two ways. The first is to pass 
the path name of the directory as a string argument to the constructor. For example, 
if we want to start the listing from the C:/JavaPrograms/Chi2 directory, then we 
write 


JFileChooser chooser 

= new JFileChooser! "C:/J avaPrograms / C h12" ) ; 
chooser. showOpenDi al o g ( n u I I ); 
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The second way is to usethesetCurrentDirectory method as follows: 

File startDir = new File("C:/]avaPrograms/Chl2"); 
chooser.setCurrentDi rectorylstartDi r); 

chooser.showOpenDi al og( nulI ); 

Notice that we have to pass a File object, not a String, to the setCurrentDirectory 
method. 

Instead of designating a fixed directory as in this example, we may wish to 
begin the listing from the current directory. Since the current directory is different 
when the program is executed from a different di rectory, we need a general approach. 
We can achieve the generality by writing 

String current = System, getPropertyl" user, dir"); 

J FiI eChooser chooser 

= new J FiI eChooser(current); 


or equivalently 

String current = System, getPropertyl "user. dir"): 

j FiI eChooser chooser 

= new J FiI eChooser! ); 

chooser.setCurrentDi rectorylnew FiI e(current) ); 


The content of current is the path name to the current directory. 

To check whether the user has clicked on the Open or Cancel button, we test 
the return val ue from the showOpenDialog method. 

int status = chooser. showOpenDi al og(nul I ) ; 

if (status == J FiIeChooser,APPROVE_OPTI ON) { 

System, out. pri ntl n("Open is clicked"); 

} else { //== J FiIeChooser. CANCEL_OPTION 
System, out. pri ntl n ( " Cancel is clicked"); 

} 

Once we determine the Open button is clicked, we can retrieve the selected file as 

File sel ectedFi I e; 

selectedFile = chooser. getSe I ectedF i I e ( ) ; 
and the current directory of the selected file as 
File currentDi rectory; 

c ur r e nt Di r ec t or y = c hoos e r, ge t Cur r e nt Di r ec t or y ( ) ; 
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Figure 12.3 A sample JFileChooser object displayed with the showCloseDialog method.The dialog title 
and the okay button are labeled Save. 


To find out the name and the full path name of a selected file, we can use the 
getName and getAbsolutePath methods of the File class. 

File file = cho oser,getSeI ectedFiI e (); 

System, out. p r i n 11 n (" Selected File: " + 

f I I e. g e t N a me () ); 

System, out. p r i n 11 n (" Full path: " + 

f I I e, get Absol ut ePat h( ) ); 

To display a JFileChooser with the Save button, we write 

chooser. showSaveDi al og ( nuI I ); 

which results in a dialog shown in Figure 12.3 (the actual listing depends on the 
machine on which the program is executed). 

The following Ch12TestJFileChooser class summarizes the methods Of JFile¬ 
Chooser and File classes. Note this sample program does not perform actual file 
input or output. 



Chapter 12 Samp I 


Program: Illustrate the use of the 

JFileChooser and File classes. 


File: Ch 12 Te s t 

*/ 


eChooser .java 
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import j a v a. i o. *; 
import j avax. swi ng, *; 

class Chl2TestJ FiI eChooser { 

public static void main (String!) args) { 

J FiI eChooser chooser; 

File file, directory; 

int status; 

chooser = new j FiI eChooser ( ) ; 

status = chooser.showOpenDi al og( nulI ) ; 

if (status == j FiI eChooser.APPROVE_OPTI ON) { 
file = chooser. getSel ectedFiI e(); 

directory = cho oser.getCurrentDi rectory () ; 

System, out. p r i n 11 n ( " Directory: 11 + 

di rectory, getName ()); 

System, out. p r i n 11 n ( " File selected to open: " + 
f i I e. g e t N a me () ); 

System, out. p r i n 11 n ( " Full path name: 11 + 

f i I e, get Absol ut ePat h() ); 


} else { 

System, out. p r i n 11 n ( 11 Open File dialog canceled"); 

} 

System, out. pri ntl n("\n\n"); 

status = chooser.showSaveDi al og( nulI ) ; 

if (status == j Fi I eChooser.APPROVE_OPTI ON) { 
file = chooser. getSel ectedFiI e(); 

directory = cho oser.getCurrentDi rectory (); 

System, out. pri ntl n("Di rectory: " + 

directory.getName ()); 

System, out. pri ntl n("Fi I e selected for saving data: 11 + 

file,getName ()); 

System, out. pri ntl n ( " Full path name: " + 

fiI e.get Absol ut ePat h( ) ); 

} else { 

System, out. pri ntl n ( “ Save File dialog canceled' 1 ); 

} 

} 

} 
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QJ C:\WINDOWS\System32\cmd.exe 


Directory: My Documents 

File selected to open: bookmark.htm 

Full path name: C:\Documents and Settings\Otoyan\My Documents\bookmark.htm 


Directory: My Documents 

File selected for saving data: sampledb.htm 

Full path name: C:\Documents and Settings\Otoyan\My Documents\sampledb.htm 


Figure 12.4 A sample output from running the Chi 2TestJFileChooser program once. 


Figure 12.4 shows a sample output of running the program once. 

There is actually no distinction between the Open and Save dialogs created, 
respectively, by showOpenDialog and showCloseDialog other than the difference in 
the button label and the dialog title. In fact, they are really a shorthand for calling 
the showDialog method. Using the showDialog method, we can specify the button 
label and the dialog title. For example, this code will produce a JFileChooser dialog 
with the text Compile as its title and label for the okay button: 

JFileChooser chooser = new j FiIeChooser (); 
chooser, s h owDi a I o g ( n uI I , " Co mp i I e " ) ; 

file filter We can use a file filter to remove unwanted files from the list. Let's say we 

want to apply a filter so only the directories and thej ava source files (those with the 
.java extension) are listed in the file chooser. To do so, we must define a subclass of 
the javax.swing.filechooser.FileFilter class and provide the accept and getDescription 
methods. The prototypes of these methods are 

public boolean a c c e p t ( FiI e file) 
public String getDescription! ) 

The accept method returns true i f the parameter file is a fileto be included in the list. 
The getDescription method returns a text that will be displayed as one of the entries 
for the "Files of Type:" drop-down list. Here's how the filter subclass is defined: 



Chapter 12 Samp I 


Program: Illustrate how to filter only 
java source files 
for listing in JFileChooser 


File: JavaFiIter.j ava 

*/ 

import java,io.File; 

import j avax.swi ng.fi I echooser. *; 


Notice that we are stating one class in the package 
explicitly, instead of using the more common form of 

import java.io.*; 

to avoid naming conflict.The java.io package has 
the interface named FileFilter. 
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class JavaFilter extends FileFilter { 

private static final String JAVA = "java"; 
private static final char DOT = 

II accepts only directories and 
//files with .java extension only 

publ i c boolean accept ( FiIe f ) { 

if (f. isDi rectory!)) { 

return true; 

} 

if (extensi on(f). equal si gnoreCase(JAVA)) { 

return true; 

} else { 

return false; 

} 

} 


//description of the filtered files 

public String get Description) ) { 

return “Java source files (.java)"; 

} 


//extracts the extension from the filename 

private String extensi on(Fi I e f) { 


String filename = f. g e t N a me () ; 
i nt I oc = f i I ename, I as11 ndex Of ( DOT); 


Data members 


accept 


( 


; ; ^ 

getDescription 


extension 


if (loc > 0 && loc < filename. length)) - 1) { 

//make sure the dot is not 

II at the first or the last character position 
return fi I ename. substri ng ( I oc+1); 

} else { 

return " ; 

} 

} 

} 


With the filter class Java Filter in place, we can set a file chooser to list only 
directories and Java source files by writing 

J FiI eChooser chooser = new J F i I eChooser ( ); 
chooser.setFiI eFi lter(new J avaFiI ter(()); 
i nt status = chooser. sho wOp e n Di a I og ( nulI ) ; 
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p 


Quick 


CHECK 


1. This question is specific to the Windows platform. Suppose you want to open a 
file progl .java inside the directory C:\JavaProjects\Chll\Step4. What is the 
actual string value you pass in the constructor for the File class? 

2. What is wrong with the following statement? 

J FiI eChooser chooser 

= new J FiI eChooser("Run"); 
chooser. showDi al og( nul I ) ; 

3. W hich method of the JFileChooser class do you use to get the filename of the 
selected file? W hat is returned from the method if the Cancel button is clicked? 


stream 

source 

destination 


FileOutput- 

Stream 


12.2 Low-Level File I/O 

Once a file is opened by properly associating a File object to it, the actual file 
access can commence. In this section, we will introduce basic objects for file 
operations. To actually read data from or write data to a file, we must create one of 
the J ava stream objects and attach it to the file. A stream is simply a sequence of 
data items, usually 8 bits per item. Java has two types of streams: an input stream 
and an output stream. An input stream has a source from which the data items 
come, and an output stream has a destination to which the data items go. To read 
data items from a file, we attach one of the Java input stream objects to the file. 
Similarly, to write data items to a file, we attach one of the Java output stream 
objects to the file. 

Java comes with a large number of stream objects for file access operations. 
We will cover only those that are straightforward and easy to learn for beginners. 
We will Study two of them in this section— FileOutputStream and FilelnputStream. 
These two objects provide low-level file access operations. In Section 12.3 we will 
study other stream objects. 

Let's first study how to write data values to a fi I e by using leOutputStream. 
Using a FileOutputStream object, we can output only a sequence of bytes, that is, 
values of data type byte. In this example, we will output an array of bytes to a file 
named samplei.data. First we create a File object: 

File outFile = new F i I e ( " s a mp lei. data"); 

Then we associate a new FileOutputStream object to outFile: 

FileOutputStream outStream 

= new FileOutputStream! outFile); 

Now we are ready for output. Consider the following byte array: 

by t e [] byt eAr r ay = { 1 0, 2 0, 3 0, 4 0, 5 0, 6 0, 7 0, 8 0 }; 
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We write the whole byte array at once to the file by executing 

outStream. wri te(byteArray); 

Notice that we are not dealing with the File object directly, but with outStream. It is 
also possibleto write array elements individually, for example, 

//output the first and fifth bytes 
outStream. wri te(byteArray[0]) ; 
outStream. wri te(byteArray[4]) ; 

After the values are written to the file, we must close the stream: 

outStream. close)); 

If the stream object is not closed, then some data may get lost due to data caching. 
Because of the physical characteristics of secondary memory such as hard disks, the 
actual process of saving data to a file is a very time-consuming operation, whether 
you are saving 1 or 100 bytes. So instead of saving bytes individually, wesavethem 
in a block of, say, 500 bytes to reduce the overall time it takes to save the whole 
data caching data. The operation of saving data as a block is called data caching. To carry out 
data caching, a part of memory is reserved as a data buffer or cache, which is used 
data buffer as a temporary holding place. A typical size for a data buffer is anywhere from 1KB 
to 2 KB. Data are first written to a buffer, and when the buffer becomes full, the data 
in the buffer are actually written to a file. If there are any remaining data in the 
buffer and the file is not closed, then those data will be lost. Therefore, to avoid 
losing any data, it is important to close the file at the end of the operations. 


I Thi ng, to Remember 

wgm 

To ensure that all data are saved to a file, close the file at the end of file access 


M any of the file operations, such as write and close, throw I/O exceptions, so 
we need to handle them. For the short sample programs, we use the propagation ap¬ 
proach. H ere's the complete program: 




Cha pt 

er 

12 Si 

a mp 1 e 

Pro 

gr a 

m: 




A t< 

JSt p 

r o g r 

a m 

t 0 

save 

File: 

Ch 

12Te: 

it Fi 1 

eOut 

put 

St r 

earn. 

*1 








i mp o r t j a 

v a. 

i o. *; 






class Chi 

2 T e 

s t F i 1 

eOut 

puts 

t r e 

a m 

{ 

public 

St 

at i c 

void 

ma i 

n ( 

St r 

i ng[ 


data to a file using FiI eOutputStream 
a v a 

Needs this clause because the file 
methods throw I/O exceptions. 

args) throws lOException { 
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II set up file and stream 

File outFile = new File("samplel.data"); 

FileOutputStream outStream = new Fi I eOutputStream) outFile); 

II data to output 

byt e [] byteArray = { 1 0, 2 0, 3 0, 4 0, 5 0, 6 0, 7 0, 8 0 }; 

//write data to the stream 
out St r earn, wr i t e( byteAr ray); 

//output done, so close the stream 

outStream. closef); 

} 

} 



It may seem odd at first to have both File and FileStream objects to input data 
from a file. Why not have just a File to handle everything? File represents a 
physical file that is a source of data. Stream objects represent the mechanism 
we associate to a file to perform input and output routines. Stream objects can 
also be associated to a nonfile data source such as a serial port. So separating 
the tasks following the STO principle resulted in more than one class to input 
data from a file. 

Now it's true that we can make a shortcut statement such as 

fileOutputStream outStream 

= new FileOutputStream) "input.txt"); 

where we avoid the explicit creation of a File object. But this shortcut does not 
eliminate the fact that the Stream object is associated to a file. 


To read the data into a program, we reverse the steps in the output routine. 
Fiieinput- We use the read method of ilelnputstream to read in an array of bytes. First we 
stream create a Fileinputstream object: 

File inFile = new File("samplel.data"); 

Fileinputstream inStream = new Fileinputstream) inFile); 

Then we read the data into an array of bytes: 

inStream, read( byteArray) ; 

Before we call the read method, we must declare and create byteArray: 

int filesize = ( i n t ) inFile. length)); 
byte[] byteArray = new byt e[ fiIesi z e] ; 
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We use the length method of the File class to determine the size of the file, which in 
this case is the number of bytes in the file. We create an array of bytes whose size is 
the size of the file. 

The foil owing program uses Fileinputstream to read in the byte array from the 
file samplel.data. 



Chapter 12 Sample Program: 

A test program to read data from a file using 
Fi I el nputStream 


Fi I e: Chl2Test Fi I el nputStream. j ava 

*1 

import j a v a. i o. *; 

class Chl2TestFi I el nputStream { 

public static void main (String!) args) throws lOException { 

II set up file and stream 

File inFile = new File("samplel.data"); 

Fileinputstream inStream = new Fi I el nputStream! inFile); 

II set up an array to read data in 

int fileSize = (int) inFile, length)); 
byte[] byteArray = new byt e[ fiI eSi ze]; 

II read data in and display them 

inStream. read(byteArray); 

for (int i = 0; i < f i I e S i z e; i ++) { 

System, out, pri ntl n(byteArray[i ]); 

} 

//input done, so close the stream 
i nSt r ea m. c I os e () ; 

} 

} 


It is possible to output data other than bytes if we can convert (i.e., typecast) 
them into bytes. For example, we can output character data by typecasting them to 
bytes. 


File outFile = new File("samp lei. data"); 

FileOutputStream outStream = new Fi I eOutputStream( outFile); 


II data to output 

byte[ ) byteArray = {(byte) 1 J 1 , 
(byte) ' a 1 , 
(byte) 1 v ', 
(byte) 'a' }; 


Typecast characters 
to bytes. 
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//write data to the stream 
outStream. wri te( byteArray) ; 

//output done, so close the stream 
outStream. cl o s e ( ); 

To read the data back, we use the read method again. If we need to display the bytes 
in the original character values, we need to typecast byte to char. Without the type¬ 
casting, numerical values would be displayed. The following code illustrates the 
typecasting of byte to char for display. 


Typecast bytes 
back to characters. 


File inFile = new File("samp lei. data 1 2 '); 

FilelnputStream inStream = new FilelnputStream) inFile); 

II set up an array to read data in 

i nt fiIeSi ze = i nFiIe,Iengt h() ; 

byte[] byteArray = new byt e[ fiI eSi ze]; 

II read data in and display them 

inStream, read(byteArray); 

for ( i nt i = 0 ; i < f i I e S i z e ; i + + ) { 

System, out, pri ntl n (( char) byteArray[i ]); 

} 

//input done, so close the stream 
i nSt r ea m, c I os e () ; 


Typecasting char to byte or byte to char is simple because A SC 11 uses 8 bits. But 
what if we want to perform file I/O on numerical values such as integers and real 
numbers? It takes more than simple typecasting to output these numerical values 
to FileOutputstream and read them back from FilelnputStream. An integer takes 
4 bytes, so we need to break a single integer into 4 bytes and perform file I/O 
on this 4 bytes. Such a conversion would be too low-level and tedious. Java 
provides stream objects that allow us to read from or write numerical values to 
a file without doing any conversions ourselves. We will discuss two of them in 
Section 12.3. 


W 

Quick 

CHECK 


1. W hat is the method you call at the end of all file I/O operations? 

2. What is wrong with the following statements? Assume that outStream is a 
properly declared and created FileOutputstream object. 

byte[ ] byteArray = {(byte) 1 H' , (byte) i 1 }; 

outStream, pri nt(byteArray); 

outStream. closet ); 
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12.3 High-Level File I/O 

By using DataOutputstream, we can output Java primitive data type values. A 
DataOutputstream object will take care of the details of converting the primitive 
data type values to a sequence of bytes. Let's look at the complete program 
first. The following program writes outvalues of various Java primitive data types 
to a file. The names of the output methods (those preceded with write) should be 
self-explanatory. 


/ * 

Chapter 12 Sample Program: 

A test programto save data to a file using 
DataOutputstream for high-level I/O. 

Fi le: Chl2Test Dat aOut put St ream, j ava 

*1 

import j a v a. i o . *; 

class Chl2Test Dat aOut put St ream { 

public static void main (String!) args) throws lOException { 

II set up the streams 

File outFile = new File("sample2.data"); 

F i I eOutputStream outF i I eStream = new F i I eOutputStrea m( outF i I e ); 

DataOutputstream outDataStream = new DataOutputstream 

(outFi I eStream); 

//write values of primitive data types to the stream 

outDataStream. writel nt(987654321); 
outDataStream. wri teLong( 11111111L); 
outDataStream, writeFI oat ( 22222222F); 
outDataStream. writeDoubl e( 3333333D); 
outDataStream. wri t e C h a r ( 1 A 1 ); 
outDataStream. writeBool ean(true); 

//output done, so close the stream 

outDataStream. closet); 

} 

} 



Notice the sequence of statements for creating a DataOutputstream object: 

File outFile = new File("sample2.data"); 

FileOutputStream outFileStrea m= new Fi I eOutputStream( outFile); 
DataOutputstream outDataStream 

= new DataOutputStream(outFi I eStream); 
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File outFile = new File( "sample2.data” ) ; 

FileOutputStream outFileStream = new FileOutputStream(outFile) ; 
DataOutputStream outDataStream = new DataOutputStream(outFileStream) ; 


writeF loat writelnt writeDouble 


\ i /- 


( OutDataStream ~) 


( OutFileStream ) 


outFile 


sample2.data 


Primitive data type 
values are written 

to outDataStream. 

Primitive data type 
values are converted to 
a sequence of bytes. 

Bytes are written to 
the file one at a time. 


Figure 12.5 A diagram showing how the three objects outFile, outFileStream, and outDataStream 

are related. 


DataOutput¬ 

Stream 


Datalnput- 

Stream 


The argument to the DataOutputStream constructor is a FileOutputStream object. 
A DataOutputStream object does not get connected to a file directly. The diagram 
in Figure 12.5 illustrates the relationships established among the three objects. The 
role of the DataOutputStream object is to provide high-level access to a file by 
converting a primitive data value to a sequence of bytes, which are then written to 
a file via a FileOutputStream object. 

To read the data back from the file, we reverse the operation. We use three 
objects: File, FilelnputStream, and DatalnputStream. The following program reads 
the data saved by the program chi2TestDataOutputstream. 



Chapter 


12 Sample Program: 

A test programto load data froma file using 
Da t a I n p u t S t r ea m f o r high-level I/O. 


FiIe: Chl2Test Datal nputStream. j ava 

*/ 

import j a v a. i o. *; 

class Chl2TestDatal nputStream { 

public static void main (String!) args) throws lOException { 


II set up file and stream 

File inFile = new File("sample2.data"); 

FilelnputStream i nFi I eStream = new FilelnputStream! inFile); 

DatalnputStream inDataStream = new Datal nputStream(i nFi I eStream); 
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File Input and Output 


II 
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St 

e m. 
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m. 

r e 

adChar () ) ; 

sy 

St 

e m. 

out 

, pr 

nt 1 

n ( 

n Da t 

aSt 

r ea 

m. 

r e 

adBool ea n ( )) ; 

II 

i n 

put 

do 

ne, 

s 0 

c 1 

ose t 

he 

st r 

ea 

m 


i n 

Da 

t a S 

t r e 

a m. 

1 os 

e ( 

; 







} 

} 


Figure 12.6 shows the relationship among the three objects. Notice that we 
must read the data back in the precise order. In other words, if we write data in the 
order of integer, float, and character, then we must read the data back in that order, 
as illustrated in Figure 12.7. If we don't read the data back in the correct order, the 
results will be unpredictable. 

binary file B oth FileOutputstream and DataOutputstream objects produce a binary file 

in which the contents are stored in the format (called binary format) in which they 
are stored in the main memory. Instead of storing data in binary format, we can 
store them in ASCII format. With the A SC 11 format, all data are converted to string 
text file data. A file whose contents are stored in A SCI I format is called a text file. One major 


File inFile = new File( "sample2.data" ) ; 

FilelnputStream inFileStream = new FileInputStream( inFile) ; 
DatalnputStream inDataStream = new DataInputStream(inFileStream) ; 


read FI oat readlnt read Double 

i /— 

inDataStreamj 


( inFileStream ) 


/—- 

inFile 

sample2.data 


Primitive data type 
values are read from 
JnDataStream. 


Primitive data type 
values are read 
from inDataStream. 

A sequence of bytes is 
converted to the primitive 
data type value. 


Bytes are read from 
the file. 


Figure 12.6 A diagram showing how the three objects inFile, inFileStream, and inDataStream are related. 
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outStream. writelnteger( ... ) ; 
outStream. writeLong( . . .); 
outStream. writeChar( . . . ) ; 
outStream. writeBoolean( .. . ) ; 



aFile 


<d nteger> 
<1 ong> 
<char > 
<bool ean> 



inStream. readlnteger( . . .); 
inStream. readLong(. .. ) ; 
inStream. readChar( . . . ) ; 
inStream. readBoolean( .. .); 


Figure 12.7 The order of write and read operations must match to read the stored data back correctly. 


benefit of a text file is that we can easily read and modify the contents of a text file 
by using any text editor or word processor. 

PrintWriter is an object we use to generate a text file. Unlike DataOutput- 
stream, where we have a separate write method for each individual datatype, Print- 
Writer supports only two output methods: print and println (for print line). An 
argument to the methods can be any primitive data type. The methods convert the 
parameter to string and output this string value. The constructor of PrintWriter, sim¬ 
ilar to the one for DataOutputstream, requires an output stream as its argument. In 
the following program, the parameter is again an instance of FileOutputstream. 


/ * * 

Chapter 12 Sample Program: 

A test programto save data to a file using 
Pr i nt Wr i t er for high-level I/O. 

File: Chl2TestPri ntWri ter.j ava 

*1 

import j a v a. i o. *; 

class Chl2TestPri ntWri ter { 

public static void main (String!) args) throws I OExcepti on { 

II set up file and stream 

File outFile = new File("sample3.data"); 

FileOutputstream outFi I eStream = new FileOutputstream) outFile); 
PrintWriter outStream = new Print Writer(outFi I eStream); 
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} 


//write values of primitive data 

outStream. pri ntl n( 987654321) ; 
outStream. pri ntl n(llllllllL); 
outStream. pri ntl n(22222222F); 
outStream. pri ntl n ( 3 3 3 3 3 3 3 3 D) ; 
outStream. pri ntl n(' A' ); 
outStream. pri ntl n(true); 


types to the stream 

We use print and println with PrintWriter. 
The print and println methods convert 
primitive data types to strings before 
writing to a file. 


//output done, so close the stream 
outStream. closef); 


To read the data from a text file, we use the FileReader and BufferedReader 
objects. The relationship between FileReader and BufferedReader is similar to the 
one between Fileinputstream and Datainputstream.To read data back from a text file, 
first we need to associate a BufferedReader object to a file. The foil owing sequence 
Of statements associates a BufferedReader object to a filesample3.data: 

File inFile = new File("sample3.data"); 

FileReader fi I eReader = new FiI eRe ader ( i nF i I e ) ; 

BufferedReader buf Reader 

= new BufferedReader ( fiI eReader ) ; 

Then we read data, using the readLine method Of BufferedReader, 

String str = bufReader, readLi ne( ); 

and convert the string to a primitive data type as necessary. 

Here's the program to read back from sample3.data, which was created by the 
program Ch12TestPrintWriter: 



Chapter 12 Sample Program: 

A test programto load data froma file using the readLine 
method of BufferedReader for high-level String input. 


Fi I e: Chl2Test Buf feredReader.j ava 

*1 

import j a v a, i o. *; 


class Chl2Test Buf feredReader { 

public static void main (String!) args) throws lOException { 

II set up file and stream 

File inFile = new File("sample3.data"); 
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F i I eReader fi I eReader = new Fi I eReader ( i nFi I e ) ; 

BufferedReader buf Reader = new Buf feredReader ( f iI eReader ) ; 

String s t r ; 


II get integer 

str = bufReader. readLi ne(); 
i nt i = I nt eger. par sel nt ( st r ) ; 

II get long 

str = bufReader. readLi ne(); 

I ong I = Long, par seLongf st r ) ; 

II get float 

str = bufReader. readLi ne(); 
float f = Float. parseFI oat(str); 

II get double 

str = bufReader. readLi ne(); 
double d = Doub I e. parseDoubI e ( str ) ; 

II get char 

str = bufReader. readLi ne(); 
char c = st r. c ha r At ( 0 ) ; 

II get boolean 

str = bufReader. readLi ne(); 

Boolean boolObj = new Bool ean(str); 
boolean b = booI Obj . booI eanVaI ue () ; 


Syst 

e m. 

out 

pr 

nt 

n ( i ) ; 

Syst 

e m. 

out 

pr 

nt 

n ( 1 ) ; 

Syst 

e m. 

out 

pr 

nt 

n(f); 

Syst 

e m. 

out 

pr 

nt 

n ( d ) ; 

Syst 

e m. 

out 

pr 

nt 

n ( c ) ; 

Syst 

e m. 

out 

pr 

nt 

n ( b ) ; 


Data are saved in ASCII format, so 
the conversion to the primitive 
data format is required. 


Note: Here we only output, so 
there's no real need to perform 
data conversion. But in general 
we need to convert ASCII data to 
primitive data types to process 
them in the program. 


//input done, so close the stream 

buf Reader.cI ose( ) ; 

} 

} 


Si nee Java 5.0, we can use the Scanner class introduced in Chapter 3 to input 
data from a text file. Instead of associating a new Scanner object to System.in, we 
can associate it to a File object. For example, 

Scanner scanner = new Scanner) 

new F i I e (" s a mp I e 3. d a t a" ) ) ; 
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will associate scanner to the file sample3.data. Once this association is made, we 
can use scanner methods such as nextint, next, and others to input data from the 
file. 

The following sample code does the same as chi2TestBufferedReader but 
uses the Scanner class instead of BufferedReader. Notice that the conversion is not 
necessary with the Scanner class by using appropriate i nput methods such as nextint 
and nextDouble. 


Chapter 12 


Samp I 
I I I 


e Program: 
ust r at e the 


use of Scanner to input text file 


File: Chl2TestScanner.j ava 

*/ 


import java,util.*; 
import j a v a. i o. *; 

class Chl2Test Scanner { 

public static void main (String a r g s []) throws FiI eNotFoundExcepti on, 

I OExc epti on { 


II open the Scanner 

Scanner scanner = new Scanner! new F i I e ( " s a mp I e 3 . d a t a " )); 
II get integer 

int i = scanner. nextlnt(); 

II get integer 

long I = scanner, next Long( ) ; 

II get float 

float f = scanner. nextFI oat(); 

II get double 

double d = scanner. nextDoubI e (); 

II get char 

char c = scanner. next (). charAt ( 0 ) ; 

II get boolean 

boolean b = scanner. nextBooI ean ( ) ; 

System, out. println(i); 

System, out. println(l); 

System, out. println(f); 

System, out. println(d); 
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System, out. pri ntl n(c); 

System, out. pri ntl n ( b ) ; 

//input done, so close the scanner 
scanner. closet); 

} 

} 


The FileManager Class 

In the Chapter 9 sample development and in Section 12.1, we used the helper class 
FileManager. A FileManager object provides file I/O operations for String data. To 
refresh our memory, here are the public methods of the class: 


Public Methods of F i I e Ma n a g e r 

public String openFiI e(Stri ng filename) 

throws FiI eNotFoundExcepti on, I OExcepti on 
Opens the text file f i I e n a me and returns the content as a S t r i n g . 
public String openFiI e ( ) throws I OExcepti on 

Opens the text file selected by the end user using the standard file open dialog 
and returns the content as a S t r I n g . 
public String saveFiI e(Stri ng filename, String data) 
throws lOException 
Saves the string data to f i I e n a me . 

public String saveFi I e(Stri ng data) throws lOException 
Saves the string data to a file selected by the end user using the standard file 
save dialog. 


The class uses the PrintWriter and BufferedReader classes for text (String) output 
and input. Notice that all public methods throw an lOException, and only the 
openFile method that accepts a filename as an argument throws FileNotFound- 
Exception also. Here is the class listing: 


Chapter 9 and Chapter 12 Helper Class 
File: File Manager.java 

*/ 

import j a v a. i o. *; 
import j avax. swi ng. *; 

class FileManager { 
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private static final String EMPTY_STRI NG = 
private static String I i neTermi nator 

= System. getProperty("l i ne, separator"); 

public F i I e Ma na ge r ( ) { 

} 

public String o p e n FiI e ( ) throws FiIeNotFoundExcepti on, 

IOException { 

String filename, doc = EMPTY_STRI NG; 

J FiI eChooser chooser = new JFileChooserf 

System, getProperty("user.di r" ); 
int reply = chooser. showOpenDialog (null); 

iffreply == J Fi I eChooser. APPROVE_OPTI ON) { 

doc = openFiI e(chooser. getSel ectedFiI e(). getAbsol utePath()); 

} 


( -;- 

openFile 


return doc; 

} 


public String openFiI e(Stri ng filename) 

throws F iI eNot F o u ndExcepti on, lOException { 


String line; 

Stri ngBuffer document = new Stri ngBuffer(EMPTY_STRI NG); 


File inFile = new File(filename); 

FiI eReader fiI eReader = new FiI eReader (i nFiI e ); 

BufferedReader buf Reader = new BufferedReader ( fiIeRe ader ); 


whi I e (true) { 

line = bufReader. readLi ne(); 


if (line == null) break; 


document. append(l i ne + I i neTermi nator); 

} 

return document.toStri ng(); 


public void saveFiI e(Stri ng data) throws lOException { 

String filename, doc = EMPTY_STRI NG; 

J FiI eChooser chooser = new JFileChooser( 

System, getProperty("user. di r"); 
int reply = chooser. showSaveDial og( null); 



} 


iffreply == J Fi I eChooser, AP P ROVE_ OPTI ON) { 


saveFiI e( chooser. getSel ectedFiI e(), getAbsol ut e Pa t h () , 
data); 


} 
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public void saveFiI e(Stri ng filename, String data) 
t hr ows I OException { 


File out Fi I e 

Fi I eOutputStream outFiIeStrearn 

Print Wr iter outStream 


new File(filename); 

new FileOutputStream(outFile); 

new Print Wri ter(outFi I eStream); 


} 


outStream, pri nt(data); 
outStream, close(); 


r—■ 

Quick 

CHECK 

V 


1. W hich type of files can be opened and viewed by a text editor? 

2. Which class is used to save data as a text file? Which class is used to read text 
files? 

3. Assume bufReader, a BufferedReader object, is properly declared and 
created. What is wrong with the following? 

double d = b u f Reader. r e a d Do u bI e ( ); 


ObjectOut- 

putStream 

Objectlnput- 

Stream 


12.4 Object I/O 

With Java, we can store objects just as easily as we can store primitive data values. 
There are object-oriented programming languages that won't allow programmers to 
store objects directly. In those programming languages, we must write code to store 
individual data members of an object separately. For example, if a Person object 
has data members name (String), age (int), and gender (char), then we have to store 
the three values individually, using the file I/O techniques explained earlier in the 
chapter. [Note: string is an object, but it can be treated much as any other primitive 
data types because of its immutability.) Now, if the data members of an object 
are all primitive data types (or a string), then storing the data members individu¬ 
ally is a chore but not that difficult. However, if a data member is a reference to 
another object or to an array of objects, then storing data can become very tricky. 
Fortunately with Java, we don't have to worry about them; we can store objects 
directly to a file. 

I n thi s secti on, we wi 11 descri be vari ous approaches for stori ng objects. To wri te 
objects to a file, we use ObjectOutputStream; and to read objects from a file, we use 
ObjectlnputStream. Let's see how we write Person objects to a file. First we need 
to modify the definition of the Person class in order for ObjectOutputStream and 
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objectinputstream to perform object I/O. We modify the definition by adding the 
phrase implements Serializable to it. 

import j a v a. i o. *; 

class Person implements Serializable { 

II the rest is the same 

} 

Whenever we want to store an object to a file, we modify its class definition by 
adding the phrase implements Serializable to it. Unlike other interfaces, such as 
ActionListener, there are no methods for us to define in the implementation class. 
All we have to do is to add the phrase. 


Serializable is 

defined in java.io. 



hinqs to Remember 

If we want to perform an object I/O, then the class definition must include the 
phrase implements Serializable. 


To save objects to a file, we first create an objectoutputstream object: 

File o u t F i I e 

= new FiI e("obj ects. dat"); 

Fi I eOutputStream outFiI eStream 

= new Fi I eOutput Str earn) outFi I e) ; 

Obj ectOutputStream outObj ectStream 

= new ObjectOutputStream 

(outFi leStream); 


To save a Person object, we write 

Person person = new Person! “Mr. Espresso", 20, ' M' ) ; 
outObj ectStream. wri teObj ect(person) ; 

The following sample program saves 10 Person objects to a file: 


/ * 

Chapter 12 Sample Program: Illustrate the use of Objectoutputstream 
FI I e: Chl2Test0bj ectOutputStream. j ava 

*1 

import java.io.*; 
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class Chl2Test0bj ectOutputStream { 

public static void main (Stri ng[] args) throws I OExcepti on { 

II set up the s t r ea ms 

File outFile = new File("objects.dat"); 

Fi I eOutputStream outFiI eStrearn 

= new F i I eOut p ut St r ea m( o ut F i I e ); 

Obj ectOutputStream outObj ectStream 

= new Obj ectOutputStream(outFi I eStream); 

//write serializable Person objects one at a time 
Person per son; 

for ( i nt i =0; i <10; i ++) { 

person = new Person! “Mr, Espresso" + i, 2 0 +i, ' M' ); 

outObj ectStream. writeObj ect(person); 

} 

//output done, so close the stream 
outObj ectStream. close!); 

} 

} 


It is possible to save different types of objects to a single file. Assuming the 
Account and Bank classes are defined properly, we can save both types of objects to 
a single file: 

Account accountl, account 2; 

Bank bankl, b a n k 2; 

accountl = new Account!); //create objects 
account 2 = new Account!); 
bankl = new Bank!); 
b a n k 2 = new Bank!); 

outObj ectStream. wri teObj ect(accountl); 
outObj ectStream. wri teObj ect(account2); 
outObj ectStream. writeObj ect(bankl ); 
outObj ectStream. writeObj ect(bank2 ); 

We can even mix objects and primitive data type values, for example, 

out Obj ec t St r ea m. wr i t el nt (15 ); 

outObj ectStream. wri teObj ect(accountl); 
o u t Obj ec t S t r ea m. wr i t eCha r (' X' ); 

To read objects from a file, we use Filelnputstream and Objectlnputstream. 
We use the method readobject to read an object. Since we can store any types of 
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ClassNot- 

Found- 

Exception 


objects to a single file, we need to typecast the object read from the file. Here's an 
example of reading a Person object we saved in the file objects.data. 

File i n F i I e 

= new F i I e (" o b j e c t s. d a t" ); 

Fi I el nputStream i nFi I eStream 

= new FilelnputStream(inFile); 

Obj ectl nputStream i nObj ectStream 

= new Obj ectl nputStreamji nFi I eStream); 

Person person = ( Person ) i nObj ectStream. readObj ect(); 

Need to typecast to the object 
type we are reading 

Because there is a possibility of wrong typecasting, the readobject method 
can throw a ClassNotFoundExceptior in addition to an lOException. You can catch 
or propagate either or both exceptions. If you propagate both exceptions, then the 
declaration of a method that contains the cal I to readobject will look like this: 

public void my Method) ) 

throws lOException, Cl assNotFoundException { 

} 

The following sample program reads the Person objects from the objects.dat 
file: 



Chapter 12 Sample Program: Illustrate the use of ObjectlnputStream 


Fi le: Chl2Test0bj ectl nputStream. j ava 

*1 


import j a v a. i o. *; 

class Chl2Test0bj ectl nputStream { 

public static void main (String!] args) throws Cl assNotFoundException, 

I OExc epti on { 


II set up file and stream 

File inFile = new F i I e ( “ objects.dat"); 

FilelnputStream i nFi I eStream 

= new FilelnputStream) inFile); 

ObjectlnputStream I nObj ect St r earn 

= new Obj ectl nputStream) i nFi I eStream); 
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II read the Person objects froma file 
Person person; 

for ( i nt i =0; i <10; i + + ) { 

person = (Person) i nObj ectStream. readObj ect(); 

System, out. pri ntl n(person.getName() + " " + 

person,g e t A g e () + " " + 

person,get Gender ()); 

} 

//input done, so close the stream 
i nObj ectStream. cl os e( ); 

} 

} 


If a file contains objects from different classes, we must read them in the cor¬ 
rect order and apply the matching typecasting. For example, if the file contains two 
Account and two Bank objects, then we must read them in the correct order: 

account 1 = (Account) i nObj ectStream. readObj ect () ; 

account 2 = (Account) i nObj ectStream. readObj ect () ; 

bankl = (Bank) i nObj ec t St r ea m. r eadObj ect () ; 

b a n k 2 = (Bank) i nObj ec t St r ea m. r eadObj ect () ; 

Now, consider the foil owing array of Person objects where N represents some 
integer value: 

Person!) people = new Person[N); 

Assuming that all N Person objects are in the array, we can store them to file as 

//save the size of an array first 

outObj ectStream. wr i tel n t ( p e o p I e. I ength); 

//save Person objects next 

for ( i nt i = 0; i < peopl e.I ength; i ++) { 
outObj ectStream. wri teObj ect ( peopl e[ i ] ); 

} 

We store the size of an array at the beginning of the file, so we know exactly how 
many Person objects to read back: 

i nt N = i nOb j e c t St r ea m. r ea d I nt () ; 

for ( i nt i =0; i < N; i ++) { 

peopl e [i] = (Person) i nObj ectStr earn, readObj ect () ; 

} 

We can actually store the whole array with a single writeObject method, 
instead of storing individual elements one at a time, that is, calling the writeObject 
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method for each element. The whole people array can be stored with a single 
statement as 

out Ob j ectStream. wr i teObj e c t ( p e o p I e) ; 

and the whole array is read back with a single statement as 

people = (Person!]) i nObj ec t St r ea m. r eadObj ect ( ); 

Notice how the typecasting is done. We are reading an array of Person objects, so 
the typecasting is (Person!]). This approach will work with any data structure object 
such as a list or map. 

The Dorm class 

In the Chapter 8 sample development, we used the helper class Dorm to manage a 
list of Resident objects. A Dorm object is capable of saving a Resident list to a file 
and reading the list from a file. The class uses object I/O discussed in this section 
to perform these tasks. A list of Resident objects is maintained by using a 
HashMap. Instead of saving Resident objects individually, the whole map is saved 
with a single writeObject method and is read by a single readobject method. (The 
map data structure was explained in Chapter 10.) Here's the complete listing: 



Chapter 8 Sample Develop me nt Helper Class 


File: Do r m. j a v a 

*/ 


import j a v a. i o. *; 
import java.util.*; 

public class Dorm { 

private Map<Stri ng, Resi dent> resi dentTabI e; 
public D o r m( ) { 

resi dentTabI e = new HashMap<Stri ng, Resi dent>(); 

} 

public Dor m( String filename) 

throws FileNotFoundException, 

I OExc epti on { 

openFi I e(fi I ename); 

} 

public void add( Resi dent resident) 

throws I I I egal ArgumentExcepti on{ 



c 


add 


if (resi dentTabl e. contai nsKey(resi dent.getName())) { 
throw new I I I egal ArgumentExcepti on( 

“Resident with the same name already exists"); 
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} else { 

resi dentTabl e. p u t ( r e s i dent. get Name( ) , resi dent); 

} 


public void del ete(Stri ng name) { 
resi dentTabl e. remove(name); 

} 


delete 


J 


public Resident getResi dent(Stri ng name) { 
return resi dentTabl e. get(name) ; 


public String getResi dentLi st( ) { 

Stri ngBuffer result = new Stri ngBuffer(""); 


getResident 


J 


getResidentList 


String tab = " \ t " ; 

String lineSeparator = System. getPropertyl " line, separator"); 


for (Resident res: resi dentTabI e,va I ues ( )) { 
result. append( res. get Name () + tab + 

res. get Room( ) + tab + 

res.get Password( ) + tab + 

Ii neSeparator); 

} 

return r es ul t.t oSt ri ng( ); 

} 

public void openFi I e(Stri ng filename) 

throws FileNotFoundException, 

I OExc epti on { 

File inFile = new File(filename); 

FilelnputStream i nFi I eStream = 

new FilelnputStream) inFile); 

Obj ec11 nputStream i nObj ectStream = 

new Obj ectl nputStreamf i nFi I eStream); 


openFile 


try { 

r e s i de n t Ta b I e = (Map<Stri ng, Resi dent>) 

i nObj ec t S t r ea m. r eadObj ec t () ; 

} catch ( Cl ass No tF o u nd Excepti on e) { 
throw new I OExcept i on( 

"Unrecognized data in the designated file' 1 ); 


} 


i nObj ect St r earn, c I ose( ) ; 

} 

public void saveFi I e(Stri ng filename) 
throws lOException { 
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} 


File outFile = new Fi I e(fi I ename); 

Fi leOutputStream outFi I eStream = 

new Fi leOutputStream) outFile); 

Obj ectOut put St ream outObj ectStream = 

new Obj ectOutputStream) outFi I eStream); 

outObj ectStream. wr i teObj ect(resi dentTabl e); 

outObjectStream. close)); 


Quick 


CHTCK 


1. W hen do you have to include the clause implements Serializable to a class 
definition? 

2. You cannot save the whole array at once—you must save the array elements 
individually, true or false? 


12.5 Sample Development 


Saving an AddressBook Object 

As an illustration of object I/O, we will write a class that handles the storage of an 
AddressBook object. The class will provide methods to write an AddressBook object 
to a file and to read the object back from the file. 

Problem Statement 

Write a class that manages file I/O of an AddressBook object. 

Overall Plan 

Before we begin to design the class, we must modify the definition of the class that 
implements the AddressBook interface by adding the phrase implements Serializable, 
such as 

import java.io.*; 
class AddressBookVerl 

/ / sa me as before 

} 

In the following discussion, we will use the implementation class AddressBookVersl. 
This modification allows us to store instances of the AddressBookVerl class. We will use 


implements AddressBook, 
Serializable { 
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the expression "an AddressBook object" to refer to an instance of any class that imple¬ 
ments the AddressBook interface. 

Since the class handles the file I/O operations, we will call the class AddressBook- 
Storage. Following the STO (single-task object) principle, this class will be responsible 
solely for file I/O of an AddressBook object. The class will not perform, for instance, any 
operations that deal with a user interface. 

What kinds of core operations should this class support? Since the class handles the 
file I/O, the class should support two public methods to write and read an AddressBook 
object. Let's call the methods write and read. The argument will be an AddressBook ob¬ 
ject we want to write or read. If filer is an AddressBookStorage object, then the calls 
should be something like 

filer. write(addressBook); 

and 


addressBook = filer, r ea d ( ); 


develop¬ 
ment steps 


For an AddressBookStorage to actually store an AddressBook object, it must 
know the file to which an address book is written or from which it is read. How should we 
let the programmer specify this file? One possibility is to let the programmer pass the file¬ 
name to a constructor, such as 

AddressBookStorage filer 

= new AddressBookStorage) 11 book, data"); 

Another possibility is to define a method to set the file, say, setFile, which is called as 

filer. setFile!" book. data"); 

Instead of choosing one over the other, we will support both. If we don't provide the 
setFile method, filer can input and output to a single file only. By using the setFile 
method, the programmer can change the file if she or he needs to. As for the constructor, 
we do not want to define a constructor with no argument because we do not want the 
programmer to create an AddressBookStorage object without specifying a filename. 
Yes, he or she can call the setFile method later, but as the AddressBookStorage class 
designer, we cannot ensure the programmer will call the setFile method. If the program¬ 
mer doesn't call the method, then the subsequent calls to the write or read method 
will fail. Some may consider assigning a default filename in a no-argument constructor. 
But what will be the default filename? No matter which filename we choose, there's a 
possibility that a file with this filename already exists, which will cause the file to be 
erased. To make our class reliable, we will not provide a no-argument constructor. 

We will implement the class in the following order: 

1. Implement the constructor and the setFile method. 

2. Implement the write method. 

3. Implement the read method. 

4. Finalize the class. 
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12.5 Sample Development— continued 


This order of development follows a natural sequence. We begin with the constructor as 
usual. Since the constructor and the setFile method carry out similar operations, we will 
implement them together. We will identify necessary data members in this step. The sec¬ 
ond step is to implement the file output routine, because without being able to write an 
AddressBook object, we won't be able to test the file input routine. For the third step, we 
will implement the file input routine. 

Step 1 Development: Constructor and setFile 

step 1 In step 1, we will identify the data members and define a constructor to initialize them. We 

design will also implement the setFile method, which should be very similar to the constructor. 

We need File, FilelnputStream, FileOutputStream, ObjectlnputStream, and 
ObjectOutputStream objects to do object I/O. Should we define a data member for 
each type of object? This is certainly a possibility, but we should not use any unnecessary 
data members. We need ObjectlnputStream and ObjectOutputStream objects only 
at the time the actual read and write operations take place. We can create these objects 
in the read and write methods, only when they are needed. Flad we used data mem¬ 
bers for all those objects, we would need to create and assign objects every time the 
setFile method was called. But calling the setFile method does not necessarily mean 
the actual file I/O will take place. Consider the case where the user changes the filename 
before actually saving an address book to a file. This will result in calling the setFile 
method twice before doing the actual file I/O. To avoid this type of unnecessary repeti¬ 
tion, we will use one data member only, a String variable filename to keep the filename. 
The setFile method simply assigns the parameter to this variable. The constructor can 
do the same by calling this setFile method, 
step 1 code At this point, we have only one data member: 

II . 

II Data Me mb e r s 
II . 

private String filename; //name of the file to store 

II an AddressBook object 

The setFile method assigns the parameter to the data member.The class is defined 
as follows: 



Chapter 12 Sample Program: Address Book Storage 


File: AddressBookStorage.java 

*1 

class Addr ess BookSt or age { 
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private String filename; 

public AddressBookStorage (String filename) { 
setFi I e(fi I ename); 

} 


} 


public void setFiI e(Stri ng filename) { 
this.filename = filename; 

System, out. p r i n 11 n ( " Inside setFi I e. 


} 


F i I e n a me is " + f i I e n a me ) ; 

//TEMP 


To test this class, we have included a temporary output statement inside the setFile 
method. We will write a test program to verify that we can create an AddressBookStorage 
object and use the setFile method correctly: 



Chapter 12 Sample Program: Driver class to test 

the skeleton AddressBookStorage 


File: TestAddressBookStorage, j ava (Step 1) 

*1 

class TestAddressBookStorage { 

public static void main (String!) args) { 

AddressBookStorage fiI eManager; 

file Manager = new AddressBookStorage) "one. data' 1 ); 
fi I eManager. setFiI e( "two. data"); 
file Manager. setFiI e(" three, data"); 

} 

} 


Step 2 Development: Implement the write Method 

ste p 2 In the second development step, we will implement the write method. From the data 

design member filename, we will create an ObjectOutputStream object and write the para¬ 

meter AddressBook object to it. A sequence of method calls to create an ObjectOutput¬ 
Stream object can throw an lOException, so we must either propagate it or handle it. 
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12.5 Sample Development— continued 


Following the STO principle, the method will propagate the thrown exception. The 
responsibility of an AddressBookStorage object is to take care of file I/O for others. 
When there's an exception, the object will inform the caller about the exception and let 
the caller decide what to do about it. 
step 2 code Here's the step 2 code with the write method: 


Chapter 12 Sample Program: The class that provides the 

file I/O for Addr ess Book 

File: AddressBookStorage, j ava 

*1 

import j a v a. i o. *; 

class AddressBookStorage { 


public void write ( AddressBook book) throws lOException { 
//first create an Obj ectOutputStream 
File outFile = new File(filename); 

Fi I eOutputStream outFi I eStream = 

new Fi I eOutputStream) outFile); 

Obj ectOut put St ream outObj ectStream = 

new Obj ect Out putSt ream) out Fi I eStream); 

//save the data to it 

outObj ectStream. writeObj ect(book); 

II and close it 

outObj ectStream. close)); 

} 

} 


We will write a test program to verify that the data are saved to a file. Since we do 
not have a method to read the file contents yet, we can only verify at this point that the 
file is created and that this file has something in it.To do so, we run the following step 2 
test program first.Then, using whatever tool available (e.g., Windows Explorer, DOS com¬ 
mand dir, UNIX command Is, etc.), we check that the specified file exists and that the file 
size is greater than zero. 
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The step 2 test program is as follows (TestAddressBookWrite is now an instan¬ 
tiate main class): 


Chapter 12 S a mp I e Program: Test the write method 
File: TestAddressBookWri te. j ava 

*1 

import j ava. i o. *; 

class TestAddressBookWrite { 

AddressBook my Book; 

AddressBookStorage fiIeManager; 

public static void main(Stri ng[] args) throws lOException { 
TestAddressBookWrite tester = new TestAddressBookWri te( 15); 

tester, wri te( "book, data"); 


public TestAddressBookWri te(i nt N) { 
my Book = new AddressBookVerl(N); 

for ( i nt i =0; i < N; i + + ) { 

Person person = new Person) "Ms. X" + i, 10, ' F ' ); 
myBook. add)person) ; 

} 

} 

public void wri te(Stri ng filename) { 

fiI eManager = new AddressBookStorage(filename); 

try { 

file Manager, wri te) my Book); 

} 

catch (lOException e) { 

System, out. pr intln)" Error: lOException is thrown."); 

} 

} 

} 


We run the program several times with different sizes for the address book and 
verify that the resulting files have different sizes. Notice that we can verify only that the 
file is created to store an AddressBook object. We cannot verify that the object is saved 
properly until we are able to read the data back, which we will do in the next step. 


www.it-ebooks.info 






722 Chapter 12 File Input and Output 


12.5 Sample Development— continued 


Step 3 Development: Implement the read Method 

In the third development step, we will implement the read method.The method reads 
the AddressBook object saved in the file and returns this object to the caller. As with the 
write method, if there's an exception, this method will propagate it back to the caller and 
let the caller decide what to do to the thrown exception. 

Here's the step 3 code with the read method: 


Chapter 12 Sample Program: The class that provides the 

file I/O for AddressBook 

File: AddressBookStorage,j ava 

*1 

import j a v a. i o. *; 

class AddressBookStorage { 


step 3 
design 


step 3 code 


► 


public AddressBook r e a d () throws lOException { 

AddressBook book; 

//first create an Obj ectI nputStream 

File inFile = new File(filename); 

FilelnputStream i nFi I eStream = 

new FilelnputStreamf inFile); 

Obj ec 11 nputStream i nObj ectStream = 

new Obj ectl nputStreamfi nFi I eStream); 

try { 

//read the data from it 

book = (AddressBook) i nObj ectStrearn, readObj ect () ; 

} 

catch ( Cl assNotFoundExcepti on e) { 
book = null; 

System, out. p r i n 11 n (" Error: AddressBook class not found"); 

} 

II and close it 

i nObj ect St r earn, c I ose( ) ; 

II and return the object 

return book; 


} 
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We will write a test program to verify that the data can be read back correctly from 
a file. To test the read operation, the file to read the data from must already exist. Instead 
of copying the data file created in step 2 to the step 3 folder, we will make this test pro¬ 
gram to save the data first by using the TestAddressBookWrite class. The step 3 test 
program is as follows: 


Chapter 12 Sample Program: Test the read (and write) method 
File: TestAddressBookRead.j ava 


import j ava. i o. *; 

class TestAddressBookRead { 

AddressBook my Book; 

AddressBookStorage fiIeManager; 

public static void mai n(Stri ng[] args) throws lOException { 

TestAddressBookWrite writer = new TestAddressBookWri te( 15); 
TestAddressBookRead reader = new TestAddressBookRead) ); 

wri ter.wri te("book. data"); 
reader. read("book. data"); 

r eader. s ea r c h("Ms. X5"); 


public void search(String name) { 

Person person; 

person = myBook. search!name) ; 
if (person != null) { 

System, out. pri nt(person. getName () + " "); 

System, out. pri nt(person. getAge() + 11 "); 

System, out. pri ntl n(person. getGender() + "\ n" ); 

} 

else { 

System, out. pri ntl n (" Error: object not found"); 

} 


public void read(String filename) { 

file Manager = new AddressBookStorage(fi lename); 

try { 

my Book = fileManager.readf); 

} 
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12.5 Sample Development— continued 


catch (I OExcepti on e) { 

System, out. print Inf" Error: lOException is thrown,"); 

} 

} 

} 


We run the program several times, changing the method body of printout to access 
different Person objects in the address book as necessary, and we verify that we can 
read the Person object in the file correctly. If you did Exercise 16 on page 615, then use 
the getFirstPerson and getNextPerson methods to access all Person objects in the 
address book. 

Step 4 Development: Finalize 

program We fi na l' ze the program in the last step. We perform a critical review for finding any incon- 

review sistency or error in the methods, incomplete methods, places to add more comments, 

and so forth. And, as always, we will carry out the final test. As the result of the critical re¬ 
final test view and final testing, we may identify and wish to implement any additional features. 


Summary 


• A File object represents a file or a directory. 

• An instance of the JFileChooser class is a file dialog that lets the user select a 
file to read data from or save data to. 

• Various input and output stream classes are defined in the java.io package. 

• Low-level file input and output read and write data 1 byte at a time. 

• Fileinputstream and FileOutputstream classes are used for low-level file I/O. 

• High-level file input and output read and write data of primitive data type. 

• Datainputstream and DataOutputstream classes are used for high-level 
file I/O. 

• With text I/O, data are read and saved as strings. 

• PrinterWriter and BufferedReader classes are used for text I/O. 

• The Scanner class can be used to input data from a text file. 

• With object I/O, data are read and saved as objects. 

• objectinputstream and objectoutputstream are used for object I/O. 

• To be able to save objects to a file, the cl ass they belong to must implement 
the Serializable interface. 
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The standard classes described or used in this chapter are 


File 

JFileChooser 

FileOutputStream 

FilelnputStream 

DataOutputStream 

DatalnputStream 

PrintWriter 


FileReader 

BufferedReader 

Scanner 

Serializable 

ObjectOutputStream 

ObjectlnputStream 


Key Concepts 


file 

directory 
file dialog 
streams 
binary files 
text files 


low-level I/O (bytes) 
high-level I/O (primitive data types) 
text I/O (strings) 
object I/O (objects) 

Serializable interface 


2 E 


Review Exercises 

1. What will happen if you forget to closea file? 

2 . What is the difference between binary files and text files? 

3. U sing the try-catch block, write a code fragment that opens a file default.dat 
when an attempt to open a user-designated file raises an exception. 

4. Using a File object, write a code fragment to display files in a user-specified 
directory. 

5. W rite a code fragment to store and read the contents of the payScaleTable 
two-dimensional array from Section 10.5 in the following two file formats: 

• A file of double values 

• A file of two-dimensional array 

Level 1 Programming Exercises ★ 

6 . Write a program that inputs words from the user and save the entered words, 
one word per line, in a text file. The program terminates when the user enters 
the word stop (case insensitive). 

7. W rite a program that reads the words from the text file created by the pro¬ 
gram of Exercise 6. After the file content is read, display the shortest word, 
the longest word, and the average length of the words. 
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8 . Repeat Exercise 6, but this time use an ArrayList of strings. Add all the words 
to the ArrayList and save the whole data as a single ArrayList object to an 
object file. 

9. Repeat Exercise 7, but this time read the data from the object file created by 
the program of Exercise 8. 

10. Write a program that randomly generates n integers and stores them in a 
binary file integers.dat. The value for /vis input by the user. Open the file 
with a text editor and see what the contents of a binary file look like. 

11 . Write a program that reads the data from the file integers.dat generated in 
Exercise 10. After the data are read, display the smallest, the largest, and the 
average. 

12. R epeat Exerci se 10, but thi s ti me, store the numbers i n a text fi I e integers.txt. 
Open this file with a text editor and verify that you can read the contents. 

13. Repeat Exercise 11 with the text file integers.txt generated in Exercise 12. 

Level 2 Programming Exercises ★★ 

14. Write a program that reads a text file and converts its content to an Eggy- 
Peggy text (see Exercise 25 of Chapter 9). Save the converted text to another 
text file. Use JFileChooser to let the user specify the input and output files. 
Create the input file by using a text editor. 

15. Extend the AddressBookstorage class by adding import and export 
capabilities. Add a method exportFile that stores the contents of AddressBook 
to a text file. Add a second method importFile that reads the text file back 
and constructs an AddressBook. This type of import/export feature is a 
convenient means to move data from one application to another. 

16. Extend the encryption application of Exercise 30 of Chapter 9 so that the 
original text is read from a user-specified text file and the encrypted text is 
stored to another user-specified text file. 

17. Extend the watermelon projectile computation program of Exercise 31 of 
Chapter 6 so the output is saved to a file. Which file format would you use for 
the program, a binary file or a text file? Or would you consider using an array 
to keep the(x, y) coordinates and save this array by using an object I/O? 

18. Extend Exercise 18 of Chapter 10 by reading the fortunes from a text file. 

M any different types of fortunes can be found at 

http:// www.chinese-fortune-cookie.com/ 
fortune-cooki e-sayi ngs. html 

You can select, cut, and paste the list of fortunes into a text file using a text 
editor such as the Notepad on the Windows platform. Name this text file 
fortunes.txt. If the website has not changed the listing style, then fortunes 
are separated by single blank lines. When you input fortunes, you have to 
skip blank lines. If you don't do this, then half of the fortunes in a list are 
blank. An alternative is to remove the blank lines, so every line in the text 
file is a fortune. You can do this manually by using a text editor or write a 
separate program that inputs this text file and output another text file with 
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all blank lines removed. When the file is very large, then it pays to write a 
separate program. 

19. Converting data in one format to another format is a very common program¬ 
ming task. In this exercise, you will input longitude and latitude information 
from a text file and output the data in KM L (Keyhole M arkup Language) 
format. K M L is a file format used in Google Earth and Google M aps to 
record geometric annotation and visualization information. A complete in¬ 
formation on K M L can be found at 

http://earth.google.com/kml 

An input file is a text file that contains a sequence of longitude and latitude 
data in thefollowing format: 

-121.87 36.61 
-3.02 16.77 
34.75 139, 76 

Longitude and latitude data are separated by a blank space. The output 
file is also a text file with information saved in KM L format. Here's an 
example: 

<? x ml versi on = "l. 0" encodi ng="UTF-8"?> 

<kml xml ns =" ht t p: / / ear t h. googl e, com/ kml / 2. 1" > 

<Doc ument > 

<n a me >My s t e r y Locati ons</name> 

<P I a c e ma r k > 

<n a me >Lo c a t i o n 1 </ na me > 

<Poi nt > 

<c o o r d i nates >- 121. 87, 36. 6 1, 0 </ c o o r d i n a t e s > 

</ Poi nt > 

</ PI a c e ma r k > 

<P I a c e ma r k > 

<n a me >Lo c a t i o n 2 </ na me > 

<Poi nt > 

<c o o r d i nates >- 3. 02, 16. 77, 0 </ c o o r d i n a t e s > 

</ Poi nt > 

</ PI a c e ma r k > 

</ Document > 

</ k ml > 

The top and the bottom portions 

<? x ml versi on="l. 0" encodi ng="UTF-8"?> 

<k ml xml ns =" http://earth.google.com/ kml / 2. 1" > 

<Doc ument > 

<n a me >My s t e r y Lo c a 11 o n s </n a me > 

</ Do c u me n t > 

</ k ml > 
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are the same for all output files. For each longitude and latitude pair, you 
generate the corresponding <Placemark> section. For example, if the data 
values are -3.02 and 16.67 for the second longitude/latitude pair, you 
generate 

<P I a c e ma r k > 

<na me >L oc a t i o n 2</ n a me > 

<Poi nt > 

<c oo r di na t es >-3. 02, 16. 77, 0</ c oo r d i na t es > 

</ Poi nt > 

</ PI a c e ma r k > 

The values that are dependent on the input data are shown in red bold text 
for illustration purpose (it's a text file, so in the actual output, there's no such 
color output). Notice that there is always the output of 0 as the third value in 
the <coordinates> section. Indentation in the output file can be achieved by 
outputting the tab (\t) characters. Use jFileChooserto allow the user to 
specify the input and output files. Create your own test input files using a 
text editor. In addition to or in lieu of checking the correctness of your out¬ 
put files manually, you can useGoogle Earth. Open your output file from 
Google Earth. If your output KM L file is correct, Google Earth will display a 
pushpin for each location (placemark) in the file. Google Earth is available 
for download from 

http: / /earth, googl e. com/down I oad - earth, html 

20. A Web browser, such as the M S Internet Explorer and the M ozilla Firefox, 
reads an HTM L file and displays the content. When you open the HTM L file 
with a text editor, you will notice that it is simply a text file with special tags. 
For example, with Firefox, you can view the content of a Web page as a 
plain text by selecting the menu choice View/Page Source. A Web browser 
uses the information contained in the HTM L tags to visually display the Web 
page. Write a program that inputs an HTM L file as a text file and count the 
number of times the LINK tag occurs in the file. For this exercise, we 
assume that the LINK tag is preceded immediately by the less than symbol 
<as 


<Ll NK 

in a case insensitive manner. 

21. Extend Exercise 20 by processing information in the LIN K tags. One of the 
information contained in the LIN K tag is the href attribute that refers to a 
linked Web page, such as 

< LI N K href=" htt p: / / www. s o me wh e r e. c o m/ i n f o. h t ml " / > 

Extend the program from Exercise 20 by extracting and displaying the Web 
addresses of the referenced pages. For the sample tag, you display the Web 
address 

http: II www. so me where, com / i nfo. html 
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The format for the href attribute is the text href (case insensitive) followed 
immediately by the equal symbol - The Web address is surrounded by the 
double quotes. 

22. Extend Exercise 21 by saving the Web addresses to a text file in addition to 
displaying them on the screen. Use JFileChooser to let the user specify the 
text file to save the Web addresses. 

Level 3 Programming Exercises ★★★ 

23. Write a program that inputs a document from a text file and saves the 
modified version to another text file. Modify the original document by 
replacing all occurrences of the word designated by the user with the text 
<blacked out>. U se JFileChooser to select the i nput and output text file 
and Scanner to i nput the word to repl ace from the user. F or the text 
replacement operation, consider using the pattern matching techniques 
discussed in Chapter 9. 

24. You need to know how to use Excel to do this exercise. At the website 

http:// www. census, gov/geneal o g y / www/ freqnames2k. ht ml 

you will find a link to an Excel file that contains 1000 most popular last 
names from the 2000 Census. Extract only the names from this file and 
save them into a text file, one name per line. Write a program that allows 
the user to search the list of most popular last names by rank and by name. 
When the user enters a rank, the program displays the corresponding last 
name. For example, if the input is 2, then the program displays the 2nd 
most popular name, which is Johnson. If the user enters a name, then the 
program displays the name's rank. For example, if the user enters M iller, 
then the program displays its rank, which is 6. 

25. Repeat Exercise 22 of Chapter 10, but this time, instead of supplying data 
values for the Element objects inside the program, read the data from a text 
file. Data on the elements in the periodic table can be found at 

ftp :II ftp. ni st.gov/pub/datapl ot/other/reference/ 

PERI ODI C. TXT 

Remove the explanatory text from the beginning of the page and save the 
page as a text file starting from the first element 

Hydrogen H 111 1.0080 0.763 3.0 1300 -999 

You only need to input the first six data values from each line. They are an 
element name, symbol, atomic number, period (row #), group (col#), and 
atomic weight. Each data item in a line is separated by one or more blank 
spaces. 

Development Exercises 

For Exercises 26 through 30, use the incremental development methodology 

to implement the program. For each exercise, identify the program tasks, create 
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a design document with class descriptions, and draw the program diagram. 

M ap out the development steps at the start. Present any design alternatives and 
justify your selection. Besureto perform adequate testing at the end of each 
development step. 

26 . Write a currency converter application. Allow the user to specify the from 
and to currencies and the amount to exchange. Use the interface of your 
choice to input these three values. When the application starts, read the 
exchange rates from a text file rate.txt. U se a text editor to create this text 
file. By using a text file, you can easily update the exchange rates. The 
format for the text file is 

<name of currency> < u ni t s per d oI I a r > 

For example, the following shows how much $1 is worth in five foreign 
currencies: 


French franc 

5. 95 

Indonesian rupiah 

12900. 0 

j apanese yen 

123.91 

Mexi c a n peso 

9. 18 

Papua New Guinea kina 

2, 381 


You can get the exchange rates from various websites, one of which is 
http://www.oanda.com. 

27 . Extend any application you have written before by adding a quote-of-the- 
day dialog. When the user starts the application, aquote of the day is 
displayed. Save the quotes in a text file. Use a random number generator 

to select the quote to display. Notice the quotes can be about any information 
(many commercial applications start with a dialog that shows tips on using 
the software). 

28 . In Exercise 24 of Chapter 5 you wrote a drive-through ordering system 
forMyJava Lo-Carb Gourmet Sandwich (the company has since changed its 
name to reflect the current trend in the food industry). You are hired again as 
a freelance computer consultant to make extensions to the program. 

Instead of having a fixed number of menu categories and a fixed 
number of menu items per category, you will input this information from a 
text file. The data in the input file have the following format: 

#menu category 

menu item $price 

menu item $price 

#menu category 

menu item $price 

Each menu category is preceded by the pound symbol (#). A list of menu 
items that belong to this menu category follows it. Each menu item includes 
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its name and price. The price is preceded by the dollar sign. H ere's a sample 
input file: 


#Entree 

Tofu Burger 

$3.99 

Chili Burger 

$2.99 

Chef Salad 

$6.99 

#Drink 

Oolong Tea 

$0.79 

Latte 

$3.29 

House Wine 

$4.99 

Chai Latte 

$2.50 

#Side 

Freedom Fries 

$0.99 

^Appetizer 

Onion Bloom 

$4.05 

Calamari 

$3.50 


You may assume that that input file contains at least one menu category and 
each menu category has at least one menu item. Also, you may assume that 
all input lines conform to the given format; that is, there will be no invalid 
input lines. Finally, there will be at most 20 menu categories and 25 menu 
items per menu category. 

After the input file data are read into a program, the operation 
mode begins, whereyou continually process the customer orders. For 
each item on the menu, keep track of the sales. At the closing time, the 
store manager keys i n a special code to shut down the program. B efore 
stopping the program, output the sales figure in a format similar to the 
following: 


Item Sales Count 

TofuBurger 25 

Cajun Chicken 30 


Total 
$ 87.25 

$ 137.70 


Today's Total Sales: $ 2761.20 


Place enough space between columns so the output is easy to read. You 
are not required to align the decimal points of the dollar figures. Output 
the sales figure to the standard output. Save the sales figure to a text file. 
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29 . W ri te an appl i cati on that removes extra spaces from a text file. In the days of 
the typewriter, it was common practiceto leavetwo spaces after periods. We 
shouldn't be doi ng that anymore with the computer, but many people sti 11 do. 
Read an original text file and output an edited version to another text file. The 
edited version should replace two or more consecutive spaces with one space. 

30 . Write a mail merge application. You use two files for this program. The first 
is a text file that contains a template letter in the following style: 


Dear <<N>>, 

Because you are <<A>> years old and <<G>>, we have a 
free gift for you. You have absolutely nothing to buy; 
just pay the shipping and handling charge of $9.99, To 
claim your gift, call us i mme d I a t e I y. 

Thank you, 

Of f i c e of Cl a i ms De pa r t me nt 


The tags «N», «a», and «G» are placeholders for the person's 
name, age, and gender. The second file contains the name, age, and gender 
information of people to whom you want to send a letter. Use whatever 
format you wish for the second file. Read two files and print out the letter 
with the placeholders replaced by the actual values from the second file. 
Run the program multiple times, each time using a different template file. 
For this program, output the personalized letter to a customized frame. 

Add menus to this frame so the user can save personalized letters to files 
(one personalized letter to a file). 
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Objectives 

After you have read and studied this chapter, you 
should be able to 

• Write programs that are easily extensible and 
modifiable by applying polymorphism in 
program design. 

• Define reusable classes based on inheritance 
and abstract classes and abstract methods. 

• Differentiate the abstract classes and Java 
interface. 

• Define methods, using the protected modifier. 

• Parse strings, using a StringTokenizer object. 



733 






734 Chapter 13 Inheritance and Polymorphism 


n this chapter, we will describe two important and powerful features in object- 
oriented programming— inheritance and polymorphism. The inheritance feature of 
object-oriented programming was introduced in Chapter 1. We will provide a more 
detailed explanation and examples of inheritance in this chapter, 
polymorphism The second major topic we cover in this chapter is polymorphism, another 

indispensable feature in object-oriented programming, which allows programmers 
to send the same message to objects from different classes. Consider the statement 

account, compute Monthl yFee () ; 

where account could be either a SavingsAccount or a checkingAccount object. If 
account is a SavingsAccount object, then the method computeMonthlyFee defined 
for the SavingsAccount class is executed. L ikewise, if account is a CheckingAccount 
object, then the method computeMonthlyFee defined for the CheckingAccount 
class is executed. Sending the same message therefore could result in executing 
polymorphic different methods. The message computeMonthlyFee is called a polymorphic mes- 

message sage because depending on the receiver object, different methods are executed. 

Polymorphism helps us write code that is easy to modify and extend. We will 
explain polymorphism in this chapter. 

13.1 A Simple Example 

Before we get into details, we start with a simple example of inheritance and poly¬ 
morphism to give a taste of what's coming. Let's begin with a class that models a 
pet. We will purposely keep the class very simplistic (e.g., we're not including any 
constructor) to focus on inheritance mechanism. Here's the definition: 

class Pet { 

private String name; 

public String get N a me ( ) { 
return n a me; 

} 

public void setNa me (String pet N a me ) { 
name = pet N a me; 

} 

public String s p e a k ( ) { 

return “I'm your cuddly little pet."; 

} 

} 

A nd here's a sample code that uses the cl ass: 

Pet my Pet = new P e t ( ); 

System, out. pri ntl nfmyPet. s p e a k ( )) ; 
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There are many different types of pets, so we really can't expect one class to 
becapableof modeling them all. Weall know how different dogs, cats, and reptiles 
are, for example. Let's define the individual Cat and Dog classes to model them a lit¬ 
tle more precisely than the generic Pet class. Now, instead of defining the two new 
classes independently, we will define them based on the Pet class. AI though they are 
different, they share common traits of being a pet, so it makes sense to derive the 
two classes from the Pet class. This is inheritance. We'll make the Dog and Cat 
classes inherit the data members and methods of the Pet class. 

Let'sseehow we might define the Cat class by using inheritance: 


This indicates Cat is 
a subclass of Pet 


class Cat extends Pet { 


} 


public String s p e a k ( ) { 

return "Don't give me orders.\n“ + 

"I speak only when I wa nt to."; 

} 


subclass We call the Cat class the subclass or derived class and the Pet class the superclass or 

superclass base c | ass yy e use the reserV ed word extends to define a subclass. Data members 

and methods of a superclass are inherited by its subclasses. So, for example, the 
following code is valid: 


Cat my Cat = new C a t ( ); 
my C a t. s e t N a me ( " C h a C h a" ) ; 

System, out. pri ntl n("Hi , my n a me is " + my C a t. g e t N a me ( )) ; 

I n the Cat class, we see that the body of the speak method is different. We say 
overrides the Cat class overrides the speak method. For example, the code 

Cat my Cat = new C a t ( ); 
myCat. setName( "Puff Puff"); 

System, out. pri ntl n ( my Cat. getNa me ( ) + " says: “); 

System, out. pri ntl n( my Cat. speak) )); 

will result in 


Puff Puff says: 

Don't give me orders. I speak only when I want to. 


We can also define additional methods and data members to a subclass. The 
following Dog class defines an additional method named fetch: 

class Dog extends Pet { 

public String fetch! ) { 

return "Yes, ma s t e r. Fetch I will."; 

} 
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polymorphic 

method 


In addition to using all the inherited methods, we can call the fetch method if it 
is a dog: 


Dog myDog = new Dog( ); 
my D o g, s e t N a me ( " Fi f i " ); 

System, out, p r i n 11 n ( my Cat, getNa me ( ) + 11 says 
System, out, printlnf my Dog. speak) )); 

System, out, println( my Dog. fetch) )); 


Fifi says: 

I'my your cuddly little pet 
Yes, mast er. Fetch I wi I I . 


Now, consider the following code: 

Pet pet One = new Dog( ) ; 

Pet pet Two = new Cat ( ) ; 

W i 11 i t work? T he answer i s yes. W hen a vari abl e (such as petone) i s decl ared to be 
of class s (such as Pet), the variable can be a reference to an instance of s or any of 
its subclasses (such as Dog and Cat). The inverse is not valid, for example: 

Dog myDog = new Pet( ); -<— invalid 

The fact that the same variable can be referring to an instance of a different 
class results in polymorphism. The following two output statements will produce 
different results, depending on whether p is a Dog or a Cat: 

Pet p; 

p = new Dog ( ) ; 

System, out. pri ntl n(p. speak( ) ); 
p = new Cat ( ); 

System, out. pri ntl n(p. speak( )); 

The speak method is called a polymorphic method. 

If a variable is declared of type s and is referring to an instance of a subclass 
of s, then we must typecast the variable to the subclass when calling noninherited 
methods of the subclass. For example, the fetch method is defined in the Dog class 
only. So code such as 

Pet p; 

p = new Dog ( ) ; 

System, out. printlnfp.fetch) )); — invalid 
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unrelated 

classes 


is invalid. We must typecast p to Dog, as in 

Pet p; 

p = new Do g ( ) ; 

System, out. pri ntl n( (( Dog ) p ). fetch ( ) ); 

W henever we need to call a method unique to a subclass, we must typecast the vari¬ 
able to the subclass if the variable's declared type is the superclass. 

To use inheritance and polymorphism effectively in our programs, weneed to 
master many rules associated with them. We will present these rules in the remain¬ 
der of the chapter. 


1. Define the Reptile class as a subclass of the Pet class. The speak method 
returns an empty string. 

2. Which one of the following statements is valid? 

Pet p = new Cat (); 

Cat c = new Pet (); 

3. Is the following code valid? 

Pet p = new Dog (); 

System, out. println(p.fetch) )); 


13.2 Defining Classes with Inheritance 

Suppose we want to maintain a class roster for a class whose enrolled students 
include both undergraduate and graduate students. For each student, we record her 
or his name, three test scores, and the final course grade. The final course grade, 
either pass or no pass, is determined by the following formula: 


Type of Student 

Grading Scheme 

Undergraduate 

Pass if (testl + test2 + test3)/3 >= 70 

Graduate 

Pass if (testl + test2 + test3)/3 >=80 


What kind of objects should we use to model undergraduate and graduate 
students? There are basically two broad ways to design the classes to model them. 
The first way is to define two unrelated classes, one for undergraduate students 
and another for graduate students. We call the two classes nrelated classes if they 
are not connected in an inheritance relationship, that is, if neither one is an ancestor 
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or descendant class of the other and they do not share a common ancestor. 1 The 
second way is to model undergraduate and graduate students by using classes that 
are related in an inheritance hierarchy. 

Defining two unrelated classes for entities that share common data or behav¬ 
ior would make class definition ineffective because we would end up duplicating 
code common to both classes. Although different, graduate and undergraduate 
students do share many common data and behaviors, so we will design these two 
classes by using inheritance. 

We will actually define three classes. The first is the student class to incor¬ 
porate behavior and data common to both graduate and undergraduate students. The 
second and third classes are the Graduatestudent class to incorporate behavior 
specific to graduate students and the UndergraduateStudent class to incorporate 
behavior specific to undergraduate students. The student class is defined as 



Chapter 


13 S a mp I e 


Program: Student 


File: Student.j ava 


class Student { 

protected final static int NUM_OF_TESTS = 3; 

protected String name; 
protected int[] test; 
protected String courseGrade; 

public St udent ( ) { 

t h i s ( " N o N a me" ); 

} 

public Student(String st udent Name) { 
name = st udent Name; 
test = new i nt [ NUM_OF_TESTS] ; 
courseGrade = "****"; 

} 

public String getCourseGradei ) { 
return courseGrade; 

} 

public String get N a me ( ) { 
return n a me; 

} 


Protected fields are visible 
to the descendant objects. 


hn J ava, the class object is automatically set to be the superclass of a class if the class definition does not 
include the keyword extends. To be technically precise, we must say that two classes are unrelated if they do 
not share a common ancestor besides object. 
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extends 


public int getTestScore(int testNumber) { 
return test[testNumber - 1] ; 

} 

public void setNa me (String newName) { 
name = newName; 

} 

public void setTestScorefint testNumber, int testScore) { 
test[testNumber-l] = testScore; 

} 

public void computeCourseGradef ) { 

II do nothing - override this method in the subclass 

} 


Notice that the modifier for the instance variables is protected, making them 
visible and accessible from the instance methods of the class and the descendant 
classes. If you declare a data member of a class private, then this data member is ac¬ 
cessible from the methods of the class only. If you declare a data member public, 
this data member is accessible from everywhere. We declare them protected so they 
are accessible from both the methods of the class and the descendant classes. We 
will explore further the protected modifier later in the chapter. 

We define the classes UndergraduateStudent and GraduateStudent as sub¬ 
classes of the student class. In Java, we say a subclass extends its superclass. The 
difference between the classes GraduateStudent and UndergraduateStudent lies in 
the way their final course grades are computed. The two subclasses are defined as 
follows: 


class GraduateStudent extends Student { 
public void computeCourseGradef) { 
int total = 0; 

for ( i nt i =0; i < NUM_OF_TESTS; i + + ) { 
total += t est [i ]; 

} 

if (total /NUM_OF_TESTS >= 80) { 
courseGrade = "Pass"; 

} else { 

courseGrade = "No Pass"; 

} 

} 

} 
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class UndergraduateStudent extends Student { 
public void comput eCourseGrade( ) { 

i nt total = 0; 

for ( int i =0; i < NUM_OF_TESTS; i ++) { 
total += t es t [i]; 

} 

if (total/ NUM_OF_TESTS >=70) { 
courseGrade = "Pass"; 

} else { 

courseGrade = "No Pass"; 

} 

} 

} 

Figure 13.1 shows the class diagram relating the three classes. Notice the use 
of the pound symbol (#) for the protected modifier. N otice also that we do not show 
inherited data members and methods in the subclasses. By seeing an inheritance 
arrow connecting a subclass to its superclass, we know that data members and meth¬ 
ods indicated on the superclass are applicable to the subclasses also. We attach 
methods and data members to the subclasses only if they are defined in the sub¬ 
classes or if they are overridden in the subclasses. In Figure 13.1, both subclasses 
have the method computeCourseGrade attached to them because the method is over¬ 
ridden in the subclasses. 



Figure 13.1 A superclass Student and its subclasses GraduateStudent and UndergraduateStudent. 


www.it-ebooks.info 





















13.3 Using Classes Effectively with Polymorphism 741 


w 

Quick 

CHECK 


1. W hich is the subclass and which is the superclass in this declaration? 

class X extends Y { ... } 

2. W hich visibility modifier allows the data members of a superclass to be 
accessible to the instances of subclasses? 


13.3 


Using Classes Effectively with Polymorphism 


Now let's see how the student class and its subclasses can be used effectively in 
the class roster program. Since both undergraduate and graduate students are en¬ 
rolled in a class, should we declare the two arrays shown below to maintain the 
class roster? 


GraduateStudent gradRoster [ 20] ; 

Undergraduat eSt udent undergr adRost er[ 20]; 

We mentioned in Chapter 10 that an array must contain elements of the same data 
type. For example, we cannot store integers and real numbers in the same array. To 
follow this rule, it seems necessary for us to declare two separate arrays, one for 
graduate students and another for undergraduate students. This rule, however, does 
not apply when the array elements are objects. We only need to declare a single 
array, for example, 

Student r ost er [40]; 

EI ements of the roster array can be i nstances of ei ther the student cl ass or any of i ts 
descendant GraduateStudent or UndergraduateStudent classes. Figure 13.2 illus¬ 
trates the array with both types of students as array elements. 

Before showing how this array is used in the program, we will explain 
the concept of polymorphism. In its simplestform, polymorphism allows a single 


roster 



Figure 13.2 The roster array with elements referring to instances of GraduateStudent or 
UndergraduateStudent classes. 
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variable to refer to objects from different classes. Consider, for example, the 
declaration 

Student student; 

With this declaration, we can say not only 

student = new Student! ) ; 

but also 

student = new GraduateStudent ( ); 


or 


student = new UndergraduateStudent ( ); 

In other words, the single variable student is not limited to referring to an 
obj ect from the student cl ass but can refer to any obj ect from the descendant cl asses 
of student. In a similar manner we can say something like 

roster! 0] = new GraduateStudent ( ); 
roster! 1] = new UndergraduateStudent ( ); 
roster! 2 ] = new UndergraduateStudent ( ); 
roster[3] = new GraduateStudent ( ); 


However, you cannot make a variable of class x refer to an object from the 
sibling classes superclass or sibling classes of x. Sibling classes are those that share the com¬ 
mon ancestor class. For example, the following assignment statements are both 
invalid. 


Gr aduateStudent gradl, g r a d 2; 

| gradl = new Student! ); 

X not valid —►] gr ad2 = nfiw under gr aduat e St udent ( ) ; 

N ow, to compute the course grade usi ng the roster array, we execute 

for ( i nt i = 0; i < numberOfStudents; i++) { 
roster! i ]. computeCourseGrade! ); 

} 

If rosterfi] refers to a GraduateStudent, then the computeCourseGrade method of 
the GraduateStudent class is executed; and if it refers to an UndergraduateStudent, 
then the computeCourseGrade method of UndergraduateStudent is executed. 
We call the message computeCourseGrade polymorphic because the message refers 
to methods from different classes depending on the object referenced by rosterfi]. 
Polymorphism allows us to maintain the class roster with one array instead of 
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benefits of 
polymorphism 


maintaining a separate array for each type of student, and this simplifies the pro¬ 
cessing tremendously. 

N otice that the statement 

r o s t e r [ i ]. comput eCourseGrade( ); 

in the sample code works because we defined the computeCourseGrade method in 
the student class. The method does nothing (its method body is empty), so its pur¬ 
pose may not be obvious. But without this method in the student class, the state¬ 
ment would result in an eror. We explained the reason at the end of Section 13.1. If 
the computeCourseGrade method were not defined in the student class, then the 
method would be unique to the individual subclasses, requiring us to typecast 
the expression roster[i] to either UndergraduateStudent or GraduateStudent. Such 
typecasting, of course, cancels out the benefits of polymorphism. Instead of defin¬ 
ing the computeCourseGrade method in the student class with an empty body, we 
could define it as an abstract method. Wewill define an abstract method and explore 
its uses in Section 13.6. 

Polymorphism makes possible smooth and easy extension and modification 
of a program. Suppose, for example, we have to add a third type of student, say, 
audit student, to the class roster program. If we have to define a separate array 
for each type of student, this extension forces us to define a new class and a third 
array for audit students. But with polymorphism, we only have to define a new 
subclass of student. And as long as this new subclass includes the correct com¬ 
puteCourseGrade method, the for loop to compute the course grade for students 
remains the same. Without polymorphism, not only do we have to add the new 
code, but also we have to rewrite existing code to accommodate the change. 
With polymorphism, on the other hand, we don't have to touch the existing code. 
M odifying existing code is a tedious and error-prone activity. A slight change to 
existing code could cause a program to stop working correctly. To be certain that a 
change in one portion of existing code won't affect other portions of existing code 
adversely, we must understand the existing code completely. And understanding 
code, especially one that is long and/or written by somebody else, is a very time- 
consuming task. 

An element of the roster array is a reference to an instance of either the 
GraduateStudent or the UndergraduateStudent class. M OSt of the time, we do not 
haveto know which is which. There are times, however, when weneed to know the 
class of a referenced object. For example, we may want to find out the number of 
undergraduate students who passed the course. To determine the class of an object, 
we use the instanceof operator. We use this operator as follows: 

Student x = new UndergraduateStudent) ); 

if ( x instanceof UndergraduateStudent ) { 

System, out. pri ntl n("Mr. X is an undergraduate student"): 

} else { 

System, out. pri ntl n("Mr. X is a graduate student"); 

} 
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This will print out Mr. x is an undergraduate student. The following code counts 
the number of undergraduate students i n the roster array. 

int under gr adCount = 0; 

for (int i = 0; i < number Of St udent s; i ++) { 

if ( r o s t e r [i] instanceof UndergraduateStudent ) { 
undergr adCount ++; 

} 

} 


W 

Quick 

CHECK 

V 


1. Suppose Truck and Motorcycle are subclasses of Vehicle. Which of these 
declarations are invalid? 

Truck t = new Vehicle(); 

Vehicle v = new Truck(); 

Motorcycle ml = new Vehicle)); 

Motorcycle m2 = new T r u c k ( ) ; 

2. W hat is the purpose of the instanceof operator? 


13.4 


Inheritance and Member Accessibility 


We will describe the rules of inheritance in this section and Sections 13.5 and 13.6. 
In this section, we will explain which members (variables and methods) of a super¬ 
class are inherited by a subclass and how these members are accessed. In addition 
to declaring members private and public, we can declare them protected. The 
protected modifier is meaningful when used with inheritance. Consider the follow¬ 
ing declarations: 


package one; 
class Super { 


super is a reserved word, so 
don't use it. 


public int publi c_Super_Fi el d; 

protected int protected_Super_Fi el d; 

private int pri vate_Super_Fi el d; 

public Super () { 

publi c_Super_Fi el d = 10; 
protected_Super_Fi el d = 20; 
pri vate_Super_Fi eld = 30; 

} 
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package t wo; 
i mport one. *; 

class Sub extends Super { 

public int publi c_Sub_Fi el d; 
protected int protected_Sub_Fi el d; 
private int pri vate_Sub_Fi el d; 

public Sub ( ) { 

publi c_Sub_Fi eld = 100; 
protected_Sub_Fi el d = 200; 
private_Sub_Fi el d = 300; 

} 

} 

Notice that the two classes Super and Sub are placed in the separate packages. We 
need to place the Sub class in a package different from the package of its superclass 
to show the effect of the protected modifier. If both the superclass and the subclass 
are in the same package, the protected modifier has no effect (it behaves the same 
as the public modifier). 

We use instance variables for illustration, but the rules we describe here are 
equally applicable to other types of members (class variables, class methods, and 
instance methods). We use the graphical representation shown in Figure 13.3 for the 
three modifiers. 

You already know the difference between the public and private modifiers. A 
public member is accessible from everywhere, but a private member is accessible 



Class hierarchy 



Instances 


Figure 13.3 A graphical representation of superclasses and subclasses with public, private, and protected 
members. (A/ofe:This representation is for illustration purposes only and is not a formal UML diagram.) 
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X NOT VALID 


X NOT VALID 


only within the same class. Let's illustrate this point. Consider a class that is unre¬ 
lated to the classes Super and Sub: 

i mp o r t one,*; 
i mpor t t wo. *; 

class Client { 

public void t est () { 

Super my Super = new Super)); 

Sub mySub = new Sub(); 


J VALID —► 


} 


} 


i nt i 
i nt j 

i nt k 


my Super, publi c_Super_Fi el d; 

mySub. publi c_Super_Fi el d; II i nheri ted 

II by mySub 

mySub. publi c_ Su b_ Fi el d; 


Public members of a class, whether they are inherited or not, are accessible 
from any object or class. Private members of a class, on the other hand, are never 
accessible from any outside object or class. The following statements, if placed in 
the test method of the client class, are therefore all invalid: 



I = my Super, pri vate_Super_Fi el d; 
m = mySub. pri vate_Super_Fi el d; 
n = mySub. pri vate_Sub_Fi el d; 


A protected member can be accessed from the cl asses in the same package and 
the subclasses in other packages. It is not accessible from the unrelated classes in 
other packages. The following statements, if placed in the test method of the client 
class, are all invalid: 


-► 


i nt o 
i nt p 
i nt q 


my Super, protected_Super_Fi el d; 
mySub. protected_Super_Fi el d; 
mySub, protected_Sub_Fi el d; 


Figure 13.4 summarizes the accessibility of class members from a method of 
an unrelated class in a different package. 

Now let's study the accessibility of class members from the methods of a Sub 
object. A method in the Sub object can access both the protected and public mem¬ 
bers of Super, but not the private members of Super. Figure 13.5 summarizes the 
accessibility of members from a method of a Sub object. 

Figure 13.5 shows the case where a method of a Sub object is accessing 
members of itself. Everything except the private members of the Super class is 
accessible from a method of the Sub class. 

What about accessing the members of an object from another object that 
belongs to the same class? If a member x, whether inherited or defined in a class, is 
accessible from an instance of the cl ass, then x is also accessible from all instances 
of the same class. Figure 13.6 illustrates that an instance can access members of 
other instances of the same class. 
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package one 



>/ - Accessible 
X - Inaccessible 


Figure 13.4 The difference between public, private, and protected modifiers. Only public members are 
visible from outside. 


Accessibility from a method 
of the Sub class 


-/ - Accessible 
X - Inaccessible 


From a method of Sub, 
everything is visible except 
the private members of its 
superclass. 


:Sub 


: Super 

1 Is/ 

1_17 


1_17 

1 17 

I X I 



1_17 

(_ 

J 


Figure 13.5 The difference between public, private, and protected modifiers. Everything except the 
private members of the Super class is visible from a method of the Sub class. 


If a data member is accessible 
from 01, that data member is 
also accessible from 02. 


01:SomeClass 


1 1 


7 


( 

) 



This could be private, 
protected, or public. 


Figure 13.6 Data members accessible from an instance are also accessible from other instances of the 
same class. 
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Consider the following two methods in the Super and Sub classes: 


cl ass Super { 


J VALID 


public 
i nt 
i nt 
i nt 

} 


void superToSuper ( Super a notherSuper ) { 
i = anotherSuper. public_Super_Fiel d; 
j = anotherSuper. protected_Super_Fi el d; 
I = anotherSuper. private_Super_Fi el d; 


} 


class Sub ext ends Super { 


public void subToSub(Sub anotherSub) { 


J VALID —► 


J VALID —► 


i nt i = anotherSub. public_Sub_Fiel d; 
i nt j = anotherSub. protected_Sub_Fi el d; 
i nt k = anotherSub. private_Sub_Fi el d; 

i nt I = a notherSub. pubIic_Super_Fi eI d; //inherited 
int m = anotherSub. protected_Super_Fi el d; //members 


X not valid —► int n = anotherSub. pri vate_Super_Fi el d; 

} 

} 


All the statements in the two methods, except the last one in subToSub, are 
valid because members accessible to an object are also accessible from other objects 
of the same cl ass. 



In addition to the private, protected, and public modifiers, Java supports the 
fourth visibility modifier, called package visibility. If no explicit modifier (public, 
private, and protected) is included in the declaration, then the component is 
package-visible, which means the component is accessible from any class that be¬ 
longs to the same package as the component's class. Likewise, protected-visible 
components are accessible to any classes in the same package, but they are also 
accessible to all subclasses outside the package. Package-visible components are 
inaccessible to any classes outside the package, so the protected visibility is less 
restrictive than the package visibility. 
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F— 

Quick 

CHECK 


1. If x is a private member of the Super class, is x accessible from a subclass of 
Super? 

2. If x is a protected member of the Super class, is x of one instance accessible 
from another instance of Super? What about from the instances of a subclass 
of Super? 


13.5 


Inheritance and Constructors 


In this section, we explain the connection between the constructors of a class and 
the inheritance mechanism. U nlike other members of a superclass, constructors of a 
superclass are not inherited by its subclasses. This means that you must define a 
constructor for a class or use the default constructor added by the compiler. As we 
mentioned in Chapter 4, a default constructor is added to a class if you do not 
declare any constructor for the class. A class definition such as 


class Person { 

public void s a y He I I o ( ) { 

System, out. pri ntl n(" We I I , hello."); 

} 

} 

is equivalent to 


class Person { 

public Person! ) { 

super!)' _ This statement ca h s the 

' superclass's constructor. 

} 

public void s a y He I I o ( ) { 

System, out. pri ntl n(" We I I , hello."); 

} 

} 


Automatically added to the 
class by the compiler 


The statement 


super! ); 

calls the superclass's constructor. Every class has a superclass. If the class declara¬ 
tion does not explicitly designate the superclass with the extends clause, then the 
class's superclass is the object class. 
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If you declare a constructor, then no default constructor is added to the class. 
For example, if you define a class as 

cl ass MyCI ass { 

public MyCI ass ( i nt x) { 

} 

} 

then a statement such as 

MyCI ass test = new MyCI a s s ( ) ; 

is invalid because MyClass has no matching constructor. 

If the constructor you define does not contain an explicit call to a superclass 
constructor, then the compiler adds the statement 

super)); 

as the first statement of the constructor. For example, if you define a constructor as 

cl ass MyCI ass { 

private int mylnt; 
public MyCI ass () { 
my I nt = 10; 

} 

} 

then the compiler will rewrite the constructor to 

public MyCI as s () { 

super) ); 

my I n t = 10; 

} 

Let's look at another example. Consider the following class definitions: 

class Vehicle { 

private String vi n; 

public Vehicl e(Stri ng vehi cl el dNumber) { 
vin = vehi cl el dNumber; 

} 
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public String get VI N( ) { 

return vi n; 

} 

} 

Since the class has a constructor, no default constructor is added to the class. This 
means a statement such as 

Vehicle my Car = new Vehicle)); 

causes a compilation error because the class does not have a matching constructor. 
This is actually what we want because we do not want to create an instance 
of Vehicle without a vehicle identification number. Now let's consider a subclass 
definition for trucks. A Truck object has one additional instance variable called 
cargoWeightLimit that refers to a maxi mum weight of cargo the truck can carry. We 
assume the truck's weight limit for cargo can vary (say, depending on how much the 
owner pays in fees). Here's our first attempt: 

class Truck extends Vehicle { 
private int cargoWeightLimit; 
public void setWeightLimit(int newLimit) { 
c a r g o We i g h t L i mi t = n e wL i mi t; 

} 

public int get We i g h t L i mi t () { 
return cargoWeightLimit; 

} 

If we compile this definition, we will get a compiler error. Since no constructor 
is defined for the class, the compiler adds a default constructor 

public void Truck() { 
super(); 

} 

This constructor calls the superclass's constructor with no arguments, but there's no 
matching constructor in the superclass. Thus, the compilation error results. Here's a 
correct definition: 


class Truck extends Vehicle { 


You need to make this call. 
Otherwise, the compiler will 
add super(), which will result 
in an error because there is no 
matching constructor in 
Vehicle. 


private int cargoWeightLimit; 

public Truck(int weightLimit, String vin) { 

-► s u pe r ( v i n ) ; 

cargoWeightLimit = weightLimit; 

} 

public void s et We i g ht L i mi t ( i nt newLimit) { 
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c a r go We i g ht L i mi t = ne wL i mi t; 

} 

public int g e t We i g h t L i mi t ( ) { 
return cargo We i g h t L i mi t; 

} 

} 

Now let's apply this knowledge to the design of the UndergraduateStudent 
and GraduateStudent classes. If we want a constructor that accepts the name, then 
we need to define such a constructor in both classes because the constructor defined 
for the student class is not inherited by these classes. Notice that we can create 
instances of these classes by 

st udent 1 = new UndergraduateStudent! ); 

st udent 2 = new GraduateStudent! ); 

because the default constructor is added by the compiler, not because the one de¬ 
fined in the student cl ass is inherited by the subclasses. Remember that constructors 
of a superclass are not inherited by its subclasses. 

Here are a rule and a guideline to remember for a subclass constructor: 



If a class has a superclass that is not the Object class, then include an explicit 
call to a constructor of the superclass in the constructor of the class. 



Always provide a constructor for every class you define. Don't rely on default 
constructors. 


Quick 

CHECK 


1. How do you call the superclass's constructor from its subclass? 

2. What statement will be added to a constructor of a subclass if it is not included 
in the constructor explicitly by the programmer? 

3. M odify the definition of GraduateStudent and UndergraduateStudent in 
Section 13.1 so we can create their instances in this way: 

studentl = new UndergraduateStudent!); 

st udent 2 = new UndergraduateStudent! “Mr, Espresso"); 

student3 = new GraduateStudent!); 

student4 = new GraduateStudent! "Ms. Latte"); 
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13.6 Abstract Superclasses and Abstract Methods 

When we define a superclass, we often do not need to create any instances of the 
superclass. In Section 13.5, we defined the student superclass and its two subclasses 
GraduateStudent and UndergraduateStudent. We gave examples of creating in¬ 
stances Of GraduateStudent and UndergraduateStudent, but not of creati ng i nstances 
of student. Does it make sense to create an instance of the student class? Depending 
on whether we need to create instances of student, we must define the class differ¬ 
ently. We will describe different ways of defining a superclass in this section. 

Even though we can create an instance of student if we want to (because of 
the way the class is currently defined), is there a need to create an instance of 
student? If a student can be only a graduate or an undergraduate student, then there 
is no need to create an instance of student. In fact, because of the way the class is 
defined, had we created an instance of student and stored it in the roster array, the 
program would crash. Why? Because the student class does not have a compute- 
CourseGrade method. 

In the following discussion, we will consider two cases. In the first case, we 
assume that a student must be either a graduate or an undergraduate student. In the 
second case, we assume that a student does not have to be a graduate or an under¬ 
graduate student (e.g., the student could be a nonmatriculated auditing student). 


Case 1: Student Must Be Undergraduate or Graduate 

For the case where a student must be a graduate or an undergraduate student, we 
only need instances Of GraduateStudent and UndergraduateStudent. So we must 
define the student class in such a way that no instances of it can be created. One 
abstract class way is to define student as an abstract class. A n abstract class is a class defined with 
the modifier abstract, and no instances can be created from an abstract class. Let's 
see how the abstract student class is defined. 


abstract class Student { 

The keyword abstract protected final static i n t NUM_OF_TESTS = 3; 

here denotes an 

abstract class. protected String name; 

protected int[] test; 

protected String courseGrade; 

public St udent ( ) { 

t h i s (" N o n a me" ); 

} 


The keyword abstract 
here denotes an 
abstract method. 


public Student(String st udent Name) { 


name = studentName; 

test = new int [ NUM_0F_TESTS ]; 

courseGrade = "****"; 


abstract public void comput eCourseGrade 


Abstract method has 
no method body, just 
a semicolon. 
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abstract 

method 


implementing 
a method 


abstract 

superclass 


public String getCourseGrade() { 
return course Grade; 

} 

public String g e t N a me ( ) { 
return n a me; 

} 

public int getTestScore(int testNumber) { 
return test[testNu mber- 1 ] ; 

} 

public void set N a me ( St r i ng newName) { 
name = newName; 

} 

public void setTestScore(int testNumber, int testScore){ 
test[testNumber-l] = testScore; 

} 

} 

An abstract method is a method with the keyword abstract, and it ends with a semi¬ 
colon instead of a method body. A class is abstract if the class contains an abstract 
method or does not provide an implementation of an inherited abstract method. We 
say a method is implemented if it has a method body. If a subclass has no abstract 
methods and no unimplemented inherited abstract methods (and does not include 
the keyword abstract in its class definition), then the subclass is no longer abstract, 
and thus its instances can be created. 

An abstract class must include the keyword abstract in its definition. Notice 
that the abstract class student has an incomplete definition because the class 
includes the abstract method computeCourseGrade that does not have a method 
body. The intent is to let its subclasses provide the implementation of the compute¬ 
CourseGrade method. If a subclass does not provide an implementation of the 
inherited abstract method, the subclass is also an abstract class, and therefore, no 
instances of the subclass can be created. Since an abstract cl ass can only makesense 
when it is a superclass, we frequently use the term abstract superclass. 



Is the Math class an abstract class? It is true that we cannot create an instance of the 
Math class, but it is not an abstract class. If a class is abstract, then you cannot cre¬ 
ate an instance of the class, but not being able to create an instance does not nec¬ 
essarily imply that the class is abstract.The intent of an abstract class is to define 
code common to all its subclasses and leave some portions, that is, abstract meth¬ 
ods, to be completed by the individual subclasses. We classify the Math class as a 
noninstantiable class, a class for which we cannot create an instance. Notice that an 
abstract class is a noninstantiable class by definition, but the reverse is not always 
true. There are noninstantiable classes, for example, the Math class, that are not 
abstract. If you want define a noninstantiable class, then simply declare a private 
constructor with no arguments and declare no other constructors for the class. 
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In a program diagram, we represent an abstract class by using the keyword 
abstract. The student abstract superclass is drawn as 


Student 

{abstract} 


Case 2: Student Does Not Have to Be Undergraduate or Graduate 

For the second case, where a student does not have to be a graduate or an under¬ 
graduate student, we can design classes in two different ways. The first approach is 
to make the student class instantiable. The second approach is to leave the student 
class abstract and add a third subclass, say, otherstudent, to handle a student who 
is neither a graduate nor an undergraduate student. Let's call students who are nei¬ 
ther graduate nor undergraduate students nonregular students. Let's assume further 
that the nonregular student will receive a pass grade if her or his average test score 
is greater than or equal to so. With the first approach, we define the student class as 


Not an abstract 
class anymore 


■►class St udent { 

protected final static int NUMOFTESTS 
protected String name; 

protected int[] test; 

protected String courseGrade; 


3; 


public Student) ) { 


t h i s (" N o n a me“ ); 

} 


Not an abstract 
method anymore 


public Student(String st udent Name) { 

name = studentName; 

test = new int [ NUM_OF_TESTS]; 

courseGrade = 11 * * * * 11 ; 


public void computeCourseGradef) { 
int total = 0; 

for ( i nt i =0; i < NUM_OF_TESTS; i ++) { 
total += t est [ i ]; 

} 


if (total /NUM_OF_TESTS >= 50) { 
courseGrade = "Pass"; 

} else { 
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courseGrade = “No Pass"; 

} 

} 

public String getCourseGrade() { 
return courseGrade; 

} 

public String g e t N a me ( ) { 
return n a me; 

} 

public int getTestScore(int testNumber) { 
return test[testNu mber- 1 ] ; 

} 

public void set N a me ( St r i ng newName) { 
name = newName; 

} 

public void setTestScore(int testNumber, int testScore) { 
test[testNumber-l] = testScore; 

} 

} 

The class is no longer abstract, and we can create an instance of student to repre¬ 
sent a nonregular student. 

With the second approach, we leave the student class abstract. To represent 
nonregular students, we define a third subclass called otherStudent as follows: 

class OtherStudent extends Student { 
public void comput eCourseGrade( ) { 
int total = 0; 

for (int i =0; i < NUM_OF_TESTS; i ++) { 
total += t es t [i]; 

} 

if (total/ NUM_OF_TESTS >=50) { 
courseGrade = "Pass"; 

} else { 

courseGrade = "No Pass"; 

} 

} 

} 

Figure 13.7 is a program diagram that includes the third subclass. 

Which approach is better? There's no easy answer. It all depends on a given 
situation. To determine which approach is better for a given situation, we can ask 
ourselves which approach allows easier modification and extension. Consider, for 
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Others tudent 


Graduates tudent 


U ndergraduate 
Student 












Figure 13.7 A program diagram of the abstract superclass Student and its three subclasses. 


example, which approach will facilitate easier modification if we have to add a new 
type of student, say, scholarship students. Or consider the case where the rule for 
assigning a course grade for the undergraduate and graduate students is modified; 
say, they become the same. 

Finally, not all methods can be declared abstract. Specifically, private meth¬ 
ods and class methods (of all visibility modifiers) cannot be abstract. 


LJlings to Remember 

The following types of methods cannot be declared as a b s t r a c t : 

• Private methods 

• Class methods (regardless of their visibility modifiers) 



W 

1. Can you create an instance of an abstract class? 

2. M ust an abstract class include an abstract method? 

3. What is wrong with the following declaration? 

class Vehicle { 

abstract public g e t VI N () ; 

} 


Quick 

CHECK 


www.it-ebooks.info 
























758 Chapter 13 Inheritance and Polymorphism 


13.7 Inheritance versus Interface 

J ava i nterface and inheritance are language features used to support object-oriented 
modeling. They are similar because they are both used to model an IS-A relation¬ 
ship. Consider, for example, the following class definitions: 

class AddressBookVerl implements Addr essBook { 

} 

class Savi ngsAccount extends Account { 

} 

We say "AddressBookVerl is an AddressBook" and "SavingsAccount is an Account.” 
Because of this similarity, beginning programmers often have some difficulty in 
differentiating the two clearly. Although they are similar, their intended uses are 
quite different. 

We use the Java interface to share common behavior (defined by its abstract 
methods) among the instances of unrelated classes. And one class can implement 
multiple interfaces. For example, we can define a single Person class that imple¬ 
ments multiple interfaces such as Driver, Commuter, and Biker. 

We use inheritance, on the other hand, to share common code (including both 
data members and methods) among the instances of related classes. A nd a single sub¬ 
class can extend at most one superclass. For example, the GraduateStudent and 
UndergraduateStudent classes are SUbclasses of the Student Class, the Truck and 
Motorcycle classes are subclasses of the Vehicle class, and so forth. The superclasses 
include data members and/or methods that are shared by the subclasses. The IS-A 
relationship that exists between a subclass and its superclass is a specialization, as 
Truck is a specialized Vehicle. Such a specialization relationship does not exist with 
the Java interface. 



Use the Java interface to share common behavior. Use the inheritance to 
share common code. 



If an entity A is a specialized form of another entity B, then model them by 
using inheritance. Declare A as a subclass ofB. 
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We must be careful not to mix up the use of service class and inheritance. 
Beginners often make this mistake. Supposeyou want to define a cl ass that maintains 
a list of music CDs. Which of the following two definitions is a better design? 

class CDManager extends j ava. utiI.ArrayLi st { 

} 

class CDManager { 
private List list; 

} 

The first version uses inheritance and defines a subclass of ArrayList. The sec¬ 
ond version defines a data member of type ArrayList. The first version is a misuse of 
inheritance. When we define a subclass A of superclass B, we must ask ourselves, 
Is A a B? Can we say CDManager is an ArrayList? No. The CDManager is not a 
specialized version of the ArrayList. The CDManager class simply needs to reuse 
the service provided by the ArrayList class. Thus, the second version is the proper 
code reuse by design. We call this type of code reuse code reuse by composition. 
composition Beyond the conceptual problem, defining the CDManager class as a subclass 

of ArrayList has practical weaknesses. Because it is a subclass, the client of the 
CDManager class can call any methods defined in the superclass ArrayList. But does 
it make sense for the client to call the method such as ensureCapacity? Another 
weakness is the difficulty in changing the implementation of the CDManager class. 
Suppose we need to modify the data structure class from ArrayList to HashMap for 
better performance. With the inheritance approach, any client that uses the inherited 
methods of ArrayList needs to be rewritten. With the composition approach, the 
client that uses only the methods defined for the CDManager class will continue to 
work without change. The change made from the ArrayList class to the HashMap 
class is encapsulated in the CDManager class and does not affect the clients. 


13.8 Sample Development 


Computing Course Grades 

Let's develop a program that illustrates the use of Student and its subclasses Graduate- 
Student and UndergraduateStudent.The program will input student data from a user- 
designated text file, compute the course grades, and display the results. We assume the 
input text file is created by using a text editor or another application. For example, a 
teacher may have kept his student grades in a notebook. Instead of manually computing 
the grades with a pencil and calculator, he enters data into a text file and uses this pro¬ 
gram to compute the course grades. Another possible scenario is that the teacher uses 
some kind of application software that allows him to maintain student records. Suppose 
this application does not allow the teacher to use different formulas for computing the 
course grades of undergraduate and graduate students. In such a case, the teacher can 
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13.8 Sample Development— continued 


export data to a text file and use our program to compute the course grades for under¬ 
graduate and graduate students using the different formulas. Using text files to transfer 
data from one application to another application is a very common technique in software 
applications. 

To focus on the use of inheritance and polymorphism, we will adopt the basic input 
and output routines. It is left as exercises to implement them differently. Exercise 9 asks 
you to save the data to an object file and Exercise 10 asks you to use the Scanner class 
for input. 

Problem Statement 

Write an application that reads in a text file organized in the manner shown 
below and displays the final course grades. The course grades are computed dif¬ 
ferently for the undergraduate and graduate students based on the formulas 
listed on page 717. The input text file format is as follows: 

• A single line is used for information on one student. 

• Each line uses the format 

<Type> <Name> <Test 1 > <Test 2> <Test 3> 

where <Type> designates either a graduate or an undergraduate student, 
<Name> designates the student's first and last name, and <Test i> designates 
the iff] test score. 

• End of input is designated by the word END. The case of the letters is insignificant. 
Figure 13.8 shows a sample input text file. 

Overall Plan 

We will implement a class that will 

1. Read an input text file. 

2. Compute the course grades. 

3. Print out the result. 


<Type> 

<N ame> 

<Testl> <Test2> 

<T est 3> 

u 

John Doe 

87 

78 

90 

G 

Jill Jones 

90 

95 

87 

G 

Jack Smith 

67 

77 

68 

U 

Mary Hines 

80 

85 

80 

U 

Mick Taylor 

76 

69 

79 


END 


Figure 13.8 A sample text file containing student names and test scores. U at the beginning of a line 
designates an undergraduate student, and G designates a graduate student. 
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program 

classes 


To read a text file, we will use the standard file I/O objects File, FileReader, 
and BufferedReader. To compute the course grades, we will use the Student, Under¬ 
graduate, and Graduate classes defined earlier in the chapter. The formulas for cal¬ 
culating the course grades are defined in their respective computeCourseGrades 
methods. Since the input file is a text file, we must create either a Graduate or an 
Undergraduate object for each line of input, so we will be able to call its compute¬ 
CourseGrades method. To store the created student objects (instances of either 
Graduate or Undergraduate), we will use an array of Student to gain more practice 
on using arrays. 

To focus on the inheritance and polymorphism topics, we will use two helper 
classes.The first is the OutputBox class which we use to display the course grades and 
save the result back to a text file. We use its print and println methods for output and its 
saveToFile method to save the data to a text file. The saveToFile method saves the 
complete text in an OutputBox to a designated file. If the file already exists, then the orig¬ 
inal contents of the file will be replaced by the text currently shown in the OutputBox. 
Often, we need the capability to save the text in different format. For example, assuming 
the student information includes the student ID number, the teacher may want to save 
only the last four digits of the ID numbers and the final course grades so the results can 
be posted. If we wish to save the text in a different format, then we have to implement our 
own method with such capability. 

The second helper class is the MainWindow class. We will name our main class 
ComputeGrades, and as another example of inheritance, we make it a subclass of 
MainWindow. The MainWindow is itself a subclass of JFrame and has the functionality 
of positioning itself at the center of the screen (among other features). We cover the 
details of subclassing the JFrame class in Chapter 14. 

Here's our working design document: 


Design Document: ComputeGrades 

Class 

Purpose 

ComputeGrades 

The top-level control object manages other objects 
in the program. The class is a subclass of the helper 
class Mai nWi n do w. This class is the instantiable main 
class. 

OutputBox 

An Ou t p u t Bo x object is used to display the input data 
and computed course grades. 

Student, Under- 

These are application logic objects for students. The 

gr aduat eSt udent, 
Graduat eSt udent 

St udent class is an abstract superclass. 

File, FileReader, 

These are objects necessary for reading data from a 

BufferedReader 

text file. 
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Figure 13.9 An object diagram of the ComputeGrades program. 


Figure 13.9 is the program diagram. 

Now let's think about the methods of ComputeGrades. What kinds of public 
methods should the class support? Since a ComputeGrades object is a top-level 
controller object. Let's define a single public method called processData to carry out the 
three main tasks. The main method of ComputeGrades will call this method. 

public static void mai n(Stri ng[] args) { 

ComputeGrades gradeComputer = new ComputeGrades!); 
gradeComputer. processData!); 

} 

The processData method will look something like this: 


this. 

s etVi si b1 e 

(true); / / ma 

ke this 

ma i 

n wi ndow 

out pu 

t Box. s et Vi 

si bl e ( t r u e ); 

//and an 

o u 

t put Box visible 

boo 1 e 

an success 

= readData! 

); 



if ( s 

uccess) { 





C 0 

mp u t e G r a d e 

(); 




pr 

i nt Res ul t ( 

); 




} el s 

e { 





pr 

i nt error 

mess age " Fi1 

e Input 

E r r 

or"; 


} 


The readData method returns true if the input data are read in correctly from 
a text file and the array of Student objects is properly created. Our working design 
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document for the ComputeGrades class is as follows: 


Design Document: The ComputeGrades Class 

Method 

Visibility 

Purpose 

<constructor> 

public 

Creates and initializes the objects used by a 
ComputeGrades object. 

p r oc es s Da t a 

public 

Displays itself and carries out three main tasks. 

readData 

p ri va t e 

Opens and reads data from a text file and creates an 
array of S t u d e n t objects from the input data. If the 
operation is successful, returns true. 

computeGrade 

p ri va t e 

Scans through the array of S t u d e n t objects and 
computes the course grades. 

p r i n t Re s u 1 t 

p ri va t e 

Prints out the student information along with the 
computed grades to an Out put Box. 


We will develop the program in five incremental steps: 

1. Start with the program skeleton. Define the skeleton ComputeGrades classes. 

2. Implement the printResult method. Define any other methods necessary to 
implement printResult. 

3. Implement the computeGrade method. Define any other methods necessary to 
implement computeGrade. 

4. Implement the readData method. Define any other methods necessary to 
implement readData. 

5. Finalize and look for improvements. 

We defer the implementation of the hardest method, readData, until the last. Some pro¬ 
grammers prefer to deal with the hardest aspect of the program first, and there's no strict 
rule for ordering the implementation steps. You should order the steps in a way with 
which you are most comfortable. Flowever, this does not mean you can implement 
the methods at random. You must always plan the implementation steps carefully so 
the steps follow a logical sequence. For this program, we start with the output routine 
so we can use it when testing other methods, instead of defining a temporary (and throw¬ 
away) output routine for testing purposes. 

Step 1 Development: Program Skeleton 

step 1 Let's begin with the data members and the constructors for the ComputeGrades class, 

design We will start with the following data members: 

private Out put Box out put Box; //for output 

private Student! ] roster; II for maintaining 

//student info 
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It is a straightforward operation to create the first four objects, but we need to think 
a little about the roster array. How big should the array be?There are several possibilities: 

1. Create an array of an arbitrary size, say, 25. 

2. Let the programmer pass the size in the constructor. 

3. Do not create it in the constructor. Modify the input text file to include the size of 
an array in the first line. 

Option 3 is not attractive because it will require a change in the problem specification. 
Moreover, requiring the size information in the input file will put a lot of burden on the 
user who must go over the text file and count the number of lines the file contains. Such 
a burdensome task should be left to a computer. So we will implement options 1 and 2. If 
the data cannot fit into an array of a predesignated size, then we will use the technique 
discussed in Chapter 10 to expand the array. (Notice that we are using an array where for 
pedagogical reasons. We can use a list such as ArrayList or LinkedList instead. Using a 
list for maintaining a roster is left as an exercise.) 

We declare a constant 

private static final i nt DEFAULT_SI ZE = 25; 
and declare the two constructors as 
public ComputeGradesf ) { 
thi s( DEFAULTSI ZE); 

} 

public ComputeGradesf i nt arraySize) { 

superf); //an explicit call to the superclass constructor 

out put Box = new OutputBox(this); 
roster = new Student [ array S i ze ] ; 

} 

Notice that we can't create inFile, fileReader, and bufReader until we know the actual 
file to open. We will create these objects in one of the methods we define later. 

For the skeleton program, we include temporary output statements in the private 
methods to verify that they are called correctly in the right order. Here's the skeleton: 


/ * 

Chapter 13 Sample Develop me nt: Compute Grades for Undergraduate 

and Graduate Students 

File: ComputeGrades.j ava 

*/ 
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II . STEP 1 . II 

class ComputeGrades extends Main Window { 

private static final i nt DEFAULTSIZE = 25; 

private Out put Box out put Box; 

private Student!] roster; 

public ComputeGrades!) { 
this! DEFAULT SIZE); 

} 

public ComputeGradesfint arraySize) { 

super!); II an explicit call to the superclass 

out put Box = new OutputBox ( this ); 
roster = new Student [ arraySi ze ]; 

} 


II 

II Mai n 
II 

public static void main(String[] args) { 

ComputeGrades gradeComputer = new ComputeGrades!); 
gradeComputer. processData(); 

} 

public void process Data!) { 
thi s. setVi si bl e(true) ; 
outputBox.setVi si bl e(true); 

boolean success = read Data!); 

if (success) { 
computeGrade(); 
pr i nt Res ul t ( ); 

} else { 

outputBox. pri ntl n("Fi I e Input Error' 1 ); 

} 

} 

private void computeGrade!) { 

outputBox, pri ntl n ( " Inside computeGrade' 1 ); II TEMP 

} 

private void print Re suit!) { 

outputBox, pri ntl n ( " Inside pri ntResul t"); //TEMP 

} 


constructor 
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private boolean readData() { 

outputBox. pri stl n("l nsi de read Data"); //TEMP 

return true; 

} 

} 


We execute the skeleton main class ComputeGrades for verification. When it is 
executed, we will see the top-level frame window (ComputeGrades) and an OutputBox 
appearing on the screen and the following messages in the OutputBox: 


1 ns i 

de 

readData 

1 ns i 

de 

c o mp u t e G r a d e 

1 ns i 

de 

pri nt Res ul t 


Step 2 Development: Implement the printResult Method 

step 2 In the second development step, we add a routine that places the result in an outputBox. 

design To implement and test this method, we need to create the roster array. We will include 

temporary code inside the readData method to build a test roster array. We can use for 
loops as in 


1-**• 

for ( i nt i = 

0; i <15; i + + ) 

{ 

1 

The first half of the 

rost er [ i ] 

= new UndergraduateStudent ( 

array is undergraduate 

r os t er [ i ] 

set N a me ( "Undergrad # " + i 

students. 





r ost er [ i ] 

setTest Score! 1, 

70 + i ) ; 


r ost er [ i ] 

setTestScore(2, 

75 + i ) ; 


r ost er [ i ] 

} 

setTestScore(3, 

80 + i ) ; 

|——► 

for ( i nt i = 

15; i < DEFAULT 

SIZE; i + + ) { 

1 

The second half of the 

r os t e r [ i ] 

= new Gr aduat eSt udent ( ); 

array is graduate 

r os t e r [ i ] 

s e t N a me ( "Grad 

# " + i ) ; 

students. 





r os t e r [ i ] 

s et Tes t Sc o r e ( 1, 

80 + i ) ; 


r os t e r [ i ] 

setTestScore(2, 

85 + i ) ; 


r os t e r [ i ] 

setTestScore(3, 

90 + i ) ; 


} 


to create a temporary roster for testing purposes. 
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Now, let's design the printResult method. When this method is called, we have 
the roster array built. The method scans through the array and retrieves the student 
data, using the getName, getCourseGrade, and getTestScore methods. Expressed in 
pseudocode, we have the following: 

for each element i in the roster array { 

output the name of r o s t e r [ i ] ; 

output the test scores of r o s t e r [ i ] ; 

output the course grade of roster[i ]; 

skip to the next line; 

i 

How should we terminate the loop? We should realize first that the roster array 
may or may not be full. For example, its default size is 25, but the actual number of ele¬ 
ments may be less than 25, so using the value of roster.length will not work. Since roster 
is an array of objects, one possible way to express the loop is as follows: 

while ( r o s t e r [ i ] ! = null) { 

//output r o s t e r [ i ] information 

} 

One problem with this while loop is that we must have at least one empty slot in the 
array for the loop to terminate correctly. We can improve it by using the length value as 

while (i < roster.length && rosterji] != null) { 

} 

If we use thefor-each loop, then we have the following: 

for (Student s: roster) { 

if (s == null) break; 

//output s information 

} 

Another possibility is to keep the count, which we set in the readData method. 
This count will be a data member of type int. Let's call this count variable studentCount. 
Then the processing loop becomes 

for (int i = 0; i < studentCount; i ++) { 

//output r o s t e r ( i ] information 

} 

We will adopt this approach because having this count information is useful for other 
purposes. For example, if we want to compute the percentage of students passing the 
course, we can use studentCount to compute it. If we don't have this variable, then every 
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time we need to compute the percentage, we have to find out the number of students in 
the roster array. 

Finally, to print out student information so the data will align properly, we will 
output the control character \t (for tab). For a simple output like this, sending tabs to 
output will work fine. For a more elaborate output, we can use the formatting technique 
discussed in Chapter 6. 

Flere's the step 2 code. Notice we add the declaration for a new data member 
studentCount, and this data member is initialized to 0 in the constructor. 



Chapter 13 Sample Develop ment: Compute Grades for Undergraduate 

and Graduate Students 


File: ComputeGrades.j ava 

*1 

II . STEP 2 . II 

class ComputeGrades extends Main Window { 


private int studentCount; 

public ComputeGrades(int arraySize) { 
studentCount = 0; 

} 


private void print Result)) { 

for (int i = 0; i < studentCount; i ++) { 

//print one student 

out put Box. pri nt (roster[i ]. g e t N a me ( )) ; 

for (int testNum = 1; testNum <= Student. NUM_OF_TESTS; 

test Nu m++) { 

out put Box. print! " \ t" + roster[i ]. getTestScore (testNum)); 

} 

outputBox. pri ntl n("\t" + roster[i].getCourseGrade()); 

} 

} 
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private boolean r e a d Da t a () { 

outputBox. pri ntl n("l nsi de readData"); //TEMP 

//TEMP 

II Create a temporary roster array to 

II test the pri nt Resul t method. 

II 

for ( i nt i =0; i <15; i + + ) { 

r o s t e r [i ] = new Undergra d u a teStudent (); 
roster[i ]. setNa me ("Undergrad # 11 + i); 


r os t e r [ i 

, s et Test Sc or e(1, 

70 

+ 

i); 

r os t e r [ i 

. setTestScore(2, 

80 

+ 

i); 

r os t e r [ i 

. setTestScore(3, 

90 

+ 

i); 

( i nt i = 

15; i < DEFAULT 

SI ZE 


i ++) 

r os t er [ i 

= new GraduateStudentj); 

rost er [i 

. s e t N a me (" G r a d # 

" + 

i 

); 

rost er [i 

. setTest Scor e(1, 

80 

+ 

i); 

rost er [i 

, setTest Scor e( 2, 

85 

+ 

i); 

rost er [i 

. setTest Scor e(3, 

90 

+ 

i); 


} 

st udentCount = DEFAULT_ SI ZE; 

return true; 

} 

} 


step 2 test 


step 3 
design 


We verify two items in this step. First, the temporary readData method includes 
creating student objects and calling their methods. Correct execution will verify that 
we are including the correct student classes and using their methods properly. Second, 
the printResult method should display the output as intended. Since we have not 
implemented the computeGrade method, we will see four asterisks for the course 
grades. We have to run the program several times and adjust the display format. Also, 
it is important to try different values for names and test scores before moving to the 
next step. 

Step 3 Development: Implement the computeGrade Method 

The functionality of computing the course grades is embedded inside the student 
classes, specifically, inside the respective computeCourseGrade methods of the 
GraduateStudent and UndergraduateStudent classes. Therefore, all we need to do in 
the computeGrade method is to scan through the roster array and call the element's 
computeCourseGrade method. This simplicity is a direct result of polymorphism. 
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step 3 code Here's the listing. The only addition is the computeGrade method. 



Chapter 13 Samp I 


Development: Compute Grades for Undergraduate 
and Graduate Students 


File: ComputeGrades. j ava 


*1 


II . STEP 3 . II 

class ComputeGrades extends Main Window { 


private void computeGradef) { 

for ( i nt i = 0; i < studentCount; i ++) { 
r o s t e r [ i ]. comput eCourseGradef ) ; 

} 

} 

} 


step 3 test We re P eat the same testing routines of step 2. Instead of seeing four asterisks for 

the course grades, we should be seeing correct values. To make the verification easy, 
we can set the fixed test scores for all students. Make sure you assign test scores that 
will result in students both passing and not passing. Don't forget to try out end cases 
such as zero for all three test scores. What about negative test scores? Will the Student 
classes handle them correctly? If we identify serious problems with the Student 
classes at this point, we may have to suspend our development until we correct the 
Student class. 

Step 4 Development: Implement the readData Method 

step 4 We w '^ now design the core function of the class, the readData method. We can 

design express the overall logic of the method in pseudocode as 

get the f i I ename from the user ; 

if (the f i I ename is provided ) 

read in data and build the roster array; 
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else 

output an error mes sage; 

We will use a JFileChooser object from the standard javax.swing package to let 
the user specify the file. If the user cancels this dialog, then null is returned. In this case, 
we print out an error message and stop. If the user specifies a file, then we pass this infor¬ 
mation to a private method buildRoster, which will read data from the designated file 
and build the roster array. 

The buildRoster method will read one line of data from the designated file at a 
time, and for each line of data, it creates an appropriate student object (an instance of 
GraduateStudent if the type is G and an instance of UndergraduateStudent if the 
type is Uj.The counter studentCount is incremented by 1 after each line is processed. 
When the line contains the terminator END, the method completes its execution. If the 
data in a line do not conform to the designated format, then the line is ignored. The 
method, expressed in pseudocode, is as follows: 

try { 

set but Reader for input; 

while (! done) { 

line = get next line; 

if (line is END ) { 

done = true; 

} else { 

student = createStudent(line); 

if (student ! = null) { 

roster [ studentCount ] = student; 

//add to roster 

studentCount ++; 

} 

} 

} 

} 

catch (lOException e) { 

output an error message; 

} 

We use the try-catch block because the creation of the BufferedReader object 
bufReader from a given filename could result in an exception. We can use the Scanner 
class instead of the FileReaderand BufferedReader classes. We create a Scanner object 
by passing a File object to the constructor. 

The createStudent method accepts a String argument, which is one line of the 
input file, and returns an instance of either GraduateStudent or UndergraduateStudent 
depending on the type specified in the line. If there's an error in the input line, then 
createStudent returns null. Instead of terminating the whole program, we will simply ig¬ 
nore the lines that do not conform to the specified format. 


createStudent will return 
null if line does not 
conform to the designated 
format. 
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In a very simplified form, the createStudent method looks like this: 

type = first element of inputLine; 

if (type, equal s(UNDER_GRAD) || type,equal s(GRAD)) { 
student = newStudentWi thData( inputLine ); 

} else { //invalid type is encountered 
student = null; 

} 

return student; 

The top statement requires us to extract the first item in the input line (String). How 
should we do it? The newStudentWithData method, which creates an instance of 
GraduateStudent or UndergraduateStudent and assigns data to it, also requires 
an operation to extract individual elements of data from a single line. We can write our 
own string processing routine to parse a given line and extract data on type, name, 
and test scores, but there's a better solution. We can use a standard class called 
StringTokenizer from the java.util package. We will take a quick detour to explain 
this class. Instead of using the StringTokenizer class, we could use the pattern-matching 
techniques with the Pattern and Matcher classes. Yet another approach is to create a 
Scanner object for each line of text, but this will result in creating say, 1000 Scanner 
objects when the input file contains 1000 lines of text. This is inefficient. The use of 
StringTokenizer class is more appropriate in a case such as this, where we need to ex¬ 
tract tokens from a given string. And, we only need to create exactly one String¬ 
Tokenizer object to process the input file. 

String- A StringTokenizer object is used to extract tokens from a given string. A token is a 

Tokenizer string of characters separated by delimiter characters, or simply delimiters. Any character 
can be designated as a delimiter, but space is the most commonly used delimiter. By 
default, a StringTokenizer object uses a white space (blank, tab, new line, or return) as its 
delimiter. Here's an example. The following code 

String input String 

= "I drink 100 cups of coffee every morning,"; 

StringTokenizer parser = new Stri ngTokeni zer(i nputStri ng); 

while ( parser. hasMoreTokens( )) { 

System, out. pri ntl n ( parser. nextToken(l); 

} 

will print out 

I 

drink 

100 

cups 


newStudentWithData will 
return null if inputLine 

contains invalid data. 
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Of 

coffee 
every 
mo r n i n g. 

The hasMoreTokens method returns true if there are more tokens remaining in 
parser, and the nextToken method returns the next token in parser. The nextToken 
method throws a NoSuchElementException if there is no token to return. Please refer 
to a java.util reference manual for more information on StringTokenizer. 



It's great if you already know about StringTokenizer, but if you don't, you're out 
of luck. You would end up programming the functionality of StringTokenizer 
yourself, redoing something that has been done already. That's always a chal¬ 
lenge for everybody, not just for beginners. Whenever you encounter a situtation 
that seems to call for a common programming task, first look up the Java API 
reference manuals. You also can ask your classmates, teaching assistant, or 
instructor for guidance. They may know something. You should also make a 
habit of browsing the Java API reference manuals so you will have general 
knowledge about the standard classes.The key is always to look for the existing 
classes to reuse. 


Now let's get back to the design. Using a StringTokenizer object, we can express 

the createStudent method as 

StringTokenizer parser = new Stri ngTokeni zer(li ne); 

String type; 

try { 

t ype = parser. nextToken)) ; 

if (type, equal s(UNDER_GRAD) || type.equal s(GRAD)) { 
student = newStudentWi thData(type, parser); 

} else { //invalid type is encountered 
student = null; 

} 

} catch (NoSuchElementException e) { II no token 
student = null; 

} 

return student; 

A private newStudentWithData method accepts a String that specifies the 
type of student and a StringTokenizer object. The method creates an instance of 


www.it-ebooks.info 





774 Chapter 13 Inheritance and Polymorphism 


13.8 Sample Development— continued 


UndergraduateStudent or GraduateStudent and assigns data to the object by calling 
the StringTokenizer object's nextToken method repeatedly: 

II type and parser are the parameters 

try { 

if (type. equal s( UNDER_ GRAD) ) { 

student = new UndergraduateStudent!); 

} else { 

student = new GraduateStudent (); 

} 

set the student na me II use parser. nextTokenf) to 

//extract data from a line 

set the student test scores 

} catch (Exception e) { //thrown by parser. nextTokenf) or 
student = null; //1 nteger. parsel nt(... ) 

} 

return student; 

Our design document for the ComputeGrades class now includes three more private 
methods: 


Design Document: The Comput e Gr a d e s Class 

Method 

Visibility 

Purpose 

bui1 dRost er 

pri vat e 

Reads one line of data from the designated file 
at a time; and for each line of data, creates an 
appropriate student object. If the data in a line do 
not conform to the designated format, then the line 
is ignored. 

createStudent 

p r i v a t e 

Creates a student object by calling 
newSt udentWi thData if the type in the input 
line is U or G. If successful, returns the created 
student; otherwise, returns n u 1 1 . 

newSt udent Wi t hDat a 

p r i v a t e 

Creates an instance of UndergraduateStudent 
orGraduat eSt udent and assigns data to the 
object by calling the Stri ngTokeni zer object's 
nextToken method repeatedly. 
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step 4 code 


Here's the complete step 4 code: 



Chapter 13 Sample Develop ment: Compute Grades for Undergraduate 

and Graduate Students 


File: ComputeGrades.java 


*/ 

import j a v a. i o. *; 
import java,util.*; 
import javax.swing.*; 


II . STEP 4 . II 

class Comput e G r ades extends MainWindow { 

private static final i nt DEFAULT_SIZE = 25; 

private static final String UNDER_GRAD = "U"; 

private static final String GRAD = " G" ; 

private static final String END_OF_FI LE_STR = "END"; 

private Out put Box out put Box; 

private Student!] roster; 

private int student Count; 

public ComputeGradesf) { 
this ( DEFAULT SIZE); 

} 

public ComputeGradesf i nt arraySize) { 

superf); // an explicit call to the superclass constructor 

out put Box = new Out put Box( thi s) ; 

roster = new S t u dent [ arra yS i ze ] ; 

student Count = 0; 

} 


II . 

II Ma i n 


public static void main(String[] args) { 

Comput eGr ades gradeComputer = new ComputeGradesf); 
g r a deCo mp ut er. p r oc es s Da t a () ; 

} 

public void process Da t a () { 
set Vi si bl e(true); 
outputBox. setVi si bl e(true); 
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boolean success = r e a d D a t a ( ) ; 

if (success) { 
computeGrade(); 
pr i nt Res ul t ( ) ; 

} else { 

outputBox. printl n("FiI e Input Error" ); 


private boolean bui I dRoster(Stri ng filename) { 
String inputLine; 

Student student; 


File 

FiI eReader 
BufferedReader 


i n F i I e; 
f i I e Re a d e r; 
buf Reader; 


boolean status = true; 
booleandone = false; 


try { 

inFile = new File(filename); 

fiI eReader = new F i I eRe ader ( i nFiI e ); 

buf Reader = new BufferedReader ( fiI eReader ) ; 

while ( !done) { 

inputLine = bufReader. readLi ne( ); II read one line 

if ( i nput Li ne. equal si gnoreCase( END_OF_FI LE_STR) ) { 
done = true; 


else { 

student = createStudent ( i nputLi ne ) ; 

if (student != nulI ) { 

roster [ studentCount ] = student; 
st udent Count ++; 

} 

} 

} II while 

buf Reader. closet); 

} 

catch (lOException e) { 
status = false; 

} 
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return status; 

} 

private void computeGradef) { 

for ( i nt i = 0; i < studentCount; i ++) { 
roster[ i ]. computeCourseGrade( ); 

} 

} 

private Student createStudent ( Stri ng line) { 

Student student; 

Stri ngTokeni zer parser = new Stri ngTokeni zer(li ne); 
String type; 

try { 

type = parser, next Token (); 

if (type, equal s(UNDER_GRAD) || type.equa I s ( GRAD) ) { 
student = newStudentWi thData(type, parser); 

} else { 

student = null; 

} 

} catch (NoSuchEI ementExcepti on e) { II no token 
student = null; 

} 

return student; 

} 


private Student newStudentWi thData(Stri ng type, 

Stri ngTokeni zer 


Student student; 


parser ) 


{ 


try { 

if (type, equal s( UNDER_GRAD) ) { 

student = new UndergraduateStudent () ; 

} else { 

student = new GraduateStudent () ; 

} 


II set the student name 

String firstName = parser. nextToken(); 

String I a s t N a me = parser. nextToken(); 

s t u d e n t. s e t N a me ( f i r s t N a me + 11 " + I a s t N a me ) ; 

II set the student test scores 

for ( i nt testNum = 1; test N u m <= Student. NUM_OF_TESTS; 

t e s t N u m+ +) { 
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student. setTestScore(testNum, Integer, p a r s e I n t ( 

parser. nextToken( )) ) ; 

} 

} catch (Exception e) { //either parser, next Token!) or 

//I nteger. parsel nt(...) thrown exception 

student = null; 

} 

return student; 

} 

private void print Result!) { 

for ( i nt i = 0; i < studentCount; i ++) ( 

//print one student 

out put Box. pri nt ( r o s t e r [ i ]. g e t N a me ( )); 

for ( i nt testNum = 1; testNum <= Student. NUM_OF_TESTS; 

test Nu m++) { 

out put Box. print! " \ t" + roster[i ] . getTestScore (testNum)); 

} 

outputBox.println(“\t" + roster[i].getCourseGrade()); 

} 

} 

private boolean read Data!) { 

II get file to open 

J FiI eChooser fiI eChooser = new JFileChooser!"."); 

//start the listing fromthe current directory 

i nt returnVal = fi I eChooser. showOpenDi al og(thi s); 

boolean result = false; 

if ( r et ur nVal == J F i I eChooser. APPROV E _OPT I ON) { 

String filename 

= fi I eChooser.getSel ectedFiI e(). getAbsol u t e P a t h () ; 
if (filename ! = null) { 

result = buiIdRoster(fiI ename); 

} 

} 

return result; 

} 

} 
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We run through a more complete testing routine in this step. We need to run the 
program for various types of input files. Some of the possible file contents are as follows: 


Step 4 Test Data 

Test File 

Purpose 

File with 5 to 20 entries of 
student information with all 
lines in correct format 

Test the normal case. 

File with 5 to 20 entries of 
student information with 
some lines in incorrect format 

Test that readData and supporting methods 
handle the error case properly. 

File with no entries 

Test that buildRoster method handles the error 
case properly. 

File with more than 25 entries 

Test that readData and supporting methods 
handle the case where the number of entries is 
larger than the default size for the roster array. 


Step 5 Development: Finalize and Improve 

program As a l wa Y s - we will finalize the program by correcting any remaining errors, inconsistency, 

review or unfinished methods. We also look for improvement in the last step. One improvement 

we can always look for relates to the length of the methods. Although there are no hard 
rules for the length, a method should not be any longer than a single page. The 
buildRoster and newStudentWithData methods are close to the maximum. If we notice 
the method is getting longer in the coding stage, we may want to rethink our design. For 
example, if the buildRoster method becomes too big, then we can define a new method 
that takes care of a portion of the method, such as moving the if-then-else statement in 
the method to a new method. 

One problem that remains (which would have been identified in step 4 testing) is 
the missing method for expanding the roster array when the input file includes more stu¬ 
dent entries than the set default size of 25. We leave this method as Exercise 3. We also 
leave some of the possible improvements as exercises. 


Summary 


I inheritance and polymorphism are powerful language features to develop 
extensible and modifiable code. 

I nheritance mechanism is used to share common code among the related 
classes. 

Inheritance is different from thejava interface, which is used to share 
common behavior among unrelated classes. 
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The third visibility modifier is the protected modifier. 

If no instances are created from a superclass, then define the superclass as an 
abstract class. 

Polymorphic messages tell us that the method executed in response to the 
message will vary according to the class to which the object belongs. 

The first statement in a constructor of a subclass must be a call to a 
constructor of the superclass. If the required statement is not made explicitly, 
then the statement to call the default constructor of the superclass is inserted 
automatically by the Java compiler. 

The standard class described or used in this chapter is stringTokenizer. 


Key Concepts 


superclass and subclass abstract superclass 

inheritance abstract methods 

inheritance and constructors polymorphism 

inheritance and visibility modifiers inheritance versus interface 


3 E 


Review Exercises 


1. Consider the following class definitions. Identify invalid statements. 


class Car { 

public String 
protected int 
private String 


ma ke; 
wei ght; 
col or; 


} 
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cl ass Tes t Mai n { 

publ i c st at i c voi dmain (Stri ng[] a r g s ) { 

Car my C a r; 

ElectricCar myElecCar; 

my C a r = new C a r () ; 
my C a r. ma ke = "Chevy"; 
myCar. wei ght = 1000; 
my C a r. c oI o r = "Red"; 

my EI e c C a r = new El ectri cCar(); 
my C a r. ma ke = "Chevy"; 
myCar. wei ght = 500; 
my C a r. c oI o r = "Silver"; 

} 

} 

2. Consider the following class definitions. Identify which calls to the 
constructor are invalid. 

cl ass Car { 

publ ic String make; 

protected i nt weight; 

pri vate String color; 

private Car (String make, i nt weight, String color) { 

thi s. ma ke = ma ke; 
thi s. wei ght = wei ght; 
thi s. c ol or = color; 

} 

publ i c C a r () { 

thi s(“ unknown", - 1, 11 whi t e" ); 

} 

cl ass El ectricCar extends Car { 
private i nt rechargeHour; 

publ ic ElectricCarC) { 

this(10); 

} 

pri vate El ectri cCar(i nt charge) { 
s u pe r (); 

rechargeHour = charge; 

} 

} 

cl ass Test Mai n { 

publ i c st at i c voi dmain (String[] args) { 

Car my Carl, myCar 2; 

ElectricCar my EI eel, my EI e c 2; 
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my C a r 1 = new C a r (); 

my C a r 2 = new Car (" Ford" , 1 2 0 0, “Green"); 

my EI e c1 = new El ect ri cCar (); 
my EI e c 2 = new El ectri cCar (15); 

} 

} 

3. How would you modify the ComputeGrades sample program if the formula 
for computing the course grade were different for freshman, sophomore, 
junior, and senior undergraduate students? Would you design four 
subclasses of UndergraduateStudent? Or would you modify the body of 
the computeCourseGrade method of UndergraduateStudent? DisCUSS the 
pros and cons of each approach. 

Level 1 Programming Exercises ★ 

4. Write a program that creates an ArrayList of pets. A n item in the list is either a 
Dog or a Cat. For each pet, enter its name and type ('c' for cat and'd' for 
dog). Stop the input when the string stop is entered for the name. After the 
input is complete, output the name and type for each pet in the list. 

5. Repeat Exercise 4, but this time group the output by printing out the names 
of al I cats fi rst and then the names of al I dogs. 

Level 2 Programming Exercises ★★ 

6. M odify the Dog class to include a new instance variable weight (double) and 
the Cat class to include a new instance variable coatColor (string). Add the 
corresponding accessors and mutators for the new instance variables. 

Modify Exercise4 by inputting additional information appropriate for the 
type. Fi rst you i nput name and type, as before. I f the type i s a cat, then i nput 
its coat color. If the type is a dog, then input its weight. After the input is 
complete, output the name, type, and coat color for the cats and the name, 
type, and weight for the dogs. 

7. In the ComputeGrades sample program, we set the default size of the roster 
array to 25. M odify the program so the size of the array will be increased if 
the input file contains more than 25 students. You need to add a method that 
expands the array, say by 50 percent. The technique to expand an array was 
discussed in Chapter 10. 

8. M odify the ComputeGrades sample program by using a list (ArrayList or 
LinkedList) instead of an array. 

9. Extend the ComputeGrades sample program by storing the roster array using 
an object file. Give an option to the user to read the data from a text file (this 
is how the original ComputeGrades works) or an object file. Similarly, give 
an option to the user to save the data to a textfile or an object file. 

10. M odify the ComputeGrades sample program to input the data from a textfile 
using the Scanner class instead Of the FileReader and BufferedReader classes. 
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Use the tab character (\t) as the delimiter. You create one Scanner object for 
the whole file. Assume the data in the file is correct. 

Level 3 Programming Exercises ★★★ 

11. In the Chapter 5 sample development, we defined the DrawableShape class 
that includes a method to draw one of the three possible shapes— rectangle, 
rounded rectangle, or ellipse. M odify the DrawableShape class as a super 
class Of the three subclasses Rectangle, RoundedRectangle, and Ellipse. 

The actual drawing of a shape is done by the drawShape method defined 

in each of the three subclasses. Using the DrawingBoard helper class 
from Chapter 5 and the four classes defined in this exercise, write a 
screensaver program that draws 10 rectangles, 15 rounded rectangles, 
and 20 ellipses of various sizes. All shapes will move smoothly across 
the screen. 

12. Suppose you have a list of Dog and Cat objects from Exercise 6 and want to 
find the average, minimum, and maximum weight of dogs. To compute these 
values, you must scan the whole list. It would be more efficient if you could 
get the results by traversing only Dog objects in the list. One approach to 
achieve this improvement is to create another list that includes only Dog 
objects (actually references to Dog objects). Here’s an example: 



RepeatExercise6,butthistimecreatetheadditional dog list. Then find the 
average, minimum, and maximum weights of the dogs by traversing the 
dog list. 

13. Perform the input routine for the Dog and Cat information as specified in 
Exercise 6. In addition to creating a main list, create separate cat and dog 
lists (see Exercise 12). After the lists are created, allow the end user to add 
or remove information. Display the following menu choices: 

1. Add Cat 

2. Add Dog 

3. Remove Cat 

4. Remove Dog 

0. Quit 
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Allow the user to remove the information by specifying the name (assume 
there are no duplicate names). When adding a new cat or a dog, input the 
corresponding data values. M ake sure to update the lists accordingly when 
adding or removing a pet. Repeat the operation until the user wants to quit. 
Notice that we use 0 for the menu choice Quit. By doing this way we don't 
have to change the code for quitting the program when we add more menu 
choices later. 

Development Exercises 

For the following exercises, use the incremental development methodology to 
implement the program. For each exercise, identify the program tasks, create 
a design document with class descriptions, and draw the program diagram. 

M ap out the development steps at the start. Present any design alternatives and 
justify your selection. Be sure to perform adequate testing at the end of each 
development step. 

14. Write a personal finance manager program that maintains information on 
your bank accounts. Incorporate these rules: 

• For the savings accounts, you can make a maximum of three 
withdrawals in a month without incurring a fee. The bank charges 
$1.00 for every withdrawal after the third. 

• For the checking accounts, the bank charges $0.50 for every check you 
write for the first 20 checks (i.e., withdrawals) in a month. After that, 
there will be no charge. 

You should be able to open and save account information to a file. You 
should be able to list all transactions of a given account or of all accounts. 
Include appropriate menus to select the options supported by the program. 
Consider using the Date class to record the date of transactions. The Date 
class is from the java.util package. Please refer to a java.util reference 
manual for information on this class. 

15. Extend the address book sample development from Chapter 10. Instead of 
managing a single type of Person, incorporate additional types of persons 
such as PersonaiFriend and BusinessAssociate. Define these classes as a 
subclass of Person. Design carefully to decide whether the Person class 
will bean abstract class. 

16. Consider an asset-tracking program that will track four types of assets: 
electronic appliances, automobiles, furniture, and compact disks. What 
classes would you design for the program? Would you define four unrelated 
classes or one superclass and four subclasses? If you design a superclass, 
will it be an abstract superclass? 

17. Implement the asset-tracking program of Exercise 10. A How the user to add, 
modify, and delete electronic appliances, automobiles, furniture, and 
compact disks. Allow the user to list the assets by category and search for 
an asset by its serial number. 


www.it-ebooks.info 


Exercises 785 


18. Extend the asset-tracking program of Exercise 11 by adding an object I/O 
capability. 

19. Write an application that reads daily temperatures for 12 months and allows 
the user to get statistics. Support at least three options: monthly average of a 
given month, yearly average, and lowest and highest temperatures of a given 
month. Use a text file to store temperatures. A line in the text file contains 
daily temperatures for one month. The first line in the text file contains 
temperatures for January; the second line, those for February; and so forth. 
UsestringTokenizer to parse a line into temperatures of type float. For a data 
structure, consider using either an array of Month or a two-dimensional 
array of float. Month is a class you define yourself. 
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Objectives 

After you have read and studied this chapter, you 
should be able to 

• Define a subclass of the JFrame class using 
inheritance. 

• Write event-driven programs using Java's 
delegation-based event model. 

• Arrange GUI objects on a window using layout 
managers and nested panels. 

• Write GUI application programs using JButton, 
JLabel, Imagelcon, JTextField, JTextArea, 

JCheckBox, JRadioButton, JComboBox, 

JList, and JSlider objects from the 
javax.swing package. 

• Write GUI application programs with menus 
using menu objects from the javax.swing 
package. 

• Write GUI application programs that process 
mouse events. 
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Introduction 


St 

he sample programs we have written so far used standard classes such as 
Scanner, PrintStream (System.out is an instance of PrintStream), and others for 
handling user interface. These standard classes are convenient and adequate for a 
basic program that does not require any elaborate user interface. For example, 
when we need to input a single integer value, calling the nextlnt method of 
Scanner once to read that input is appropriate and effective. However, when we 
need to input, say, 10 values for a Student object (e.g., name, age, address, phone 
number, GPA), then using the Scanner class can be problematic because there is 
no simple and elegant way to allow the user to reenter any one of the values after 
all 10 input values are entered. So, instead of using the standard console input, 
it is a much better user interface to employ a single customized window that 
allows the user to enter all 10 values. We will learn how to build such a cus¬ 
tomized user interface in this chapter. As a part of building of a customized user 
interface, we will also learn how to detect mouse movements and clicking of 
mouse buttons. 



When we write a program for our own use, then we may choose to use the 
standard console input to enter 10 values. When we write a program for others, 
however, an effective user interface becomes of paramount importance. Next to 
the program correctness, the user interface of a program is often the most 
important criterion for the users to select one program over another, so it is criti¬ 
cal for the success of the program to include the user interface that is logical, easy 
to use, and visually appealing. 


graphical user 
interface 


Swing and 
AWT classes 


The type of user interface we cover in this chapter is called a graphical user 
interface (GUI). In contrast, the user interface that uses System.in and System.out 
exclusively is the called the non-GUI, or console user interface. In Java, GUI-based 
programs are implemented by using the classes from the standard javax.swing and 
java.awt packages. We will refer to them collectively as GUI classes. When we 
need to differentiate them, we will refer to the classes from javax.swing as Swing 
classes and those from java.awt as AWT classes. Some of the GUI objects from the 
javax.swing package are shown in Figure 14.1. 

In the older versions of Java (before Java 2 SDK 1.2), we had only AWT 
classes to build GUI-based programs. Many of the AWT classes are now superseded 
by their counterpart Swing classes (e.g., AWT Button class is superseded by Swing 
JButton class). AWT classes are still available, but it is generally preferable to use 
Swing classes. There are two main advantages in using the Swing classes over the 
AWT classes. 
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JMenu 


JFrame 


JLabel 


Imagelcon 


JTextField 


JButton 


Figure 14.1 Various GUI objects from the javax.swing package. 


First, the Swing classes provide greater compatibility across different oper¬ 
ating systems. The Swing classes are implemented fully in Java, and they behave 
the same on different operating systems. The AWT classes, on the other hand, are 
implemented by using the native GUI objects. For example, an AWT Button is 
implemented by using the Windows button object for the Windows operating sys¬ 
tem, the Macintosh button object for the Mac operating system, and so forth. 
Because the behaviors of underlying platform-specific GUI objects are not neces¬ 
sarily identical, an application that uses AWT classes may not behave the same on 
the different operating systems. To characterize the difference in implementation, 
the Swing classes are called lightweight classes and the AWT classes heavyweight 
classes. 

Second, the Swing classes support many new functionalities not supported by 
the AWT counterparts. For example, we can easily display an image inside a button 
in addition to a text by using a Swing JButton, but only text can be displayed inside 
a button with an AWT Button. 

We discuss the Swing classes exclusively. We use the AWT classes only when 
there are no counterpart Swing classes. One thing we must be careful of in using 
them is not to mix the counterparts in the same program because of their differences 
in implementation. For example, we should not mix Swing buttons and AWT but¬ 
tons or Swing menus and AWT menus. If an AWT class has no counterpart Swing 
class, for example, the AWT Graphics class, then using it with other Swing classes 
poses no problem. 



hings to Remember 


The Swing classes are called lightweight classes and the AWT classes heavy¬ 
weight classes. As a general rule, because they are implemented differently, it is 
best not to mix the counterparts (e.g., Swing JButton and AWT ButtonJ in the 
same program. 
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C[\ou 

U Might 
Want to 

Know 


Many AWT classes are superseded by the Swing counterpart classes, but they are 
still available in the newer versions of Java SDK. Why? For example, if the Swing 
JButton class is a better version of the AWT Button class, then why don't we get rid 
of the Button class? The first reason is the backward compatibility, which means 
programs written for older Java SDKs will continue to run under newer SDKs. Had a 
newer Java SDK dropped the superceded AWT classes, then old programs that use 
those AWT classes would not run under the newer version of Java. The second 
reason is the availability of compatible Java interpreters. When you write a pro¬ 
gram using Swing classes, then the users of your program must have a compatible 
Java interpreter installed on their machines. If your users employ a Java interpreter 
that recognizes only AWT classes, then you have no option but to write the pro¬ 
gram using only the AWT classes. 


To build an effective graphical user interface using objects from the javax.swing 
event-driven and java.awt packages, we must learn a new style of program control called event- 

programming driven programming. An event occurs when the user interacts with a GUI object. 

For example, when you move the cursor, click on a button, or select a menu choice, 
an event occurs. In event-driven programs, we program objects to respond to these 
events by defining event-handling methods. In this chapter we will learn the 
fundamentals of event-driven programming. 

Since the main objective for this chapter is to teach the fundamentals of GUI 
and event-driven programming and not to provide an exhaustive coverage of the 
Swing classes, we will cover only the most common GUI objects. 


14.1 Simple GUI I/O with JOptionPane 

One of the easiest ways to provide a simple GUI-based input and output is by using 
the JOptionPane class. For example, when we execute the statement 

J Opti onPane. showMessageDi al ogfnul I , "I Love Java 11 ); 

the dialog shown in Figure 14.2 appears on the center of the screen. 

In a GUI environment, there are basically two types of windows: a general- 
purpose frame and a special-purpose dialog. In Java, we use a JFrame object for 
a frame window and a JDialog object for a dialog. The first argument to the 
showMessageDialog method is a frame object that controls this dialog, and the 
second argument is the text to display. In the example statement, we pass null, a 
reserved word, meaning there is no frame object. If we pass null as the first argu¬ 
ment. the dialog appears on the center of the screen. If we pass a frame object, then 
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Figure 14.2 A simple "message"dialog created by the showMessageDialog method by using the 

JOptionPane class. 

the dialog is positioned at the center of the frame. Run the Ch14ShowMessageDia- 
log class and confirm this behavior. 


Chi 4ShowMessageDialog 
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x. s wi n g. *; 
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Di al og { 





publ i 
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i c voi 

d ma i n ( S t r 

i n g [ 

] 

args) { 
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j F r a me 

1 





j 
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= new 

j F r a me () ; 
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og 

( j F r a me, " 

How are you? 

J 

Op 

t i o n 

Pane.s 

howMes sage 

Di a 1 

og 

(null, 11 Good Bye" ) ; 


} 

} 


Notice that we are not creating an instance of the JDialog class directly by our¬ 
selves. However, when we call the showMessageDialog method, the JOptionPane 
class is actually creating an instance of JDialog internally. Notice that showMes¬ 
sageDialog is a class method, and therefore we are not creating a JOptionPane object. 
If we need a more complex dialog, then we create an instance of JDialog. But for a 
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simple display of text, calling the showMessageDialog class method of JOptionPane 
would suffice. 

If we want to display multiple lines of text, we can use a special character 
sequence \n to separate the lines, as in 

j Opti onPane.s ho wMessageDi al o g ( n u I I , "one\ntwo\nthree"); 

which will result in a dialog shown in Figure 14.3. 

We can also use the JOptionPane class for input by using its showInputDialog 
method. For example, when we execute 

J Opti onPane. showl nput Di al og(nul I , "Enter text:' 1 ); 

the dialog shown in Figure 14.4 appears on the screen. To assign the name input to 
an input string, we write 

String input; 

input = J Opti onPane.showl nputDi al og(nul I , "Enter text:"); 

Unlike the Scanner class that supports different input methods for specific 
data types, that is, nextlnt and nextDouble, the JOptionPane supports only a string 



Figure 14.3 A dialog with multiple lines of text. 



Figure 14.4 An input dialog that appears as a result of calling the showInputDialog class method of the 
JOptionPane class with "What is your name?" as the method's second argument. 
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Table 14.1 Common wrapper classes and their conversion methods. 


Class 

Method 

Example 

1 nt eger 

pa r s el nt 

1 n t e g e r. p a r s e 1 n t ( " 2 5") -> 2 5 

1 nteger. parsel nt( "25. 3") -> error 

Long 

parseLong 

Long. parseLong("25") —> 2 5 L 

Long. parseLong("25. 3") -terror 

Float 

par seFI oat 

FI oat. parseFI oat("25. 3") 25. 3F 

FI oat. parseFI oat("ab3") —> error 

Doubl e 

par seDoubl e 

Doubl e. parseDoubl e("25") ->25.0 

Doubl e. parseDoubl e("ab3") -> error 


input. To input a numerical value, we need to perform the string conversion our¬ 
selves. To input an integer value, say, age, we can write the code as follows: 

String s t r 

= J OptionPane. showl nput Di al og( nul I , "Enter age:"); 
int age = Integer. parselnt(str); 

If the user enters a string that cannot be converted to an int, for example, 12.34 or 
abc123, a NumberFormatException error will result. We use corresponding wrapper 
classes to convert the string input to other numerical data values. 

Table 14.1 lists common wrapper classes and their corresponding conversion 
methods. 


Quick 

CHECK 


L Display the message I Love Java by using JOptionPane. 

2. Using JOptionPane input dialog, write a statement to input the person’s first 
name. 

3. Using JOptionPane input dialog, write a statement to input the person’s age 
(integer). 


14.2 Customizing Frame Windows 

To create a customized user interface, we often define a subclass of the JFrame class. 
The helper class MainWindow we used in the Sample Development section of 
Chapter 13, for example, is a subclass of the JFrame class. The JFrame class contains 
the most rudimentary functionalities to support features found in any frame win¬ 
dow, such as minimizing the window, moving the window, and resizing the window. 
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In writing practical programs, we normally do not create an instance of the JFrame 
class because a JFrame object is not capable of doing anything meaningful. For 
example, if we want to use a frame window for a word processor, we need a frame 
window capable of allowing the user to enter, cut, and paste text; change font; 
print text; and so forth. To design such a frame window, we would define a subclass 
of the JFrame class and add methods and data members to implement the needed 
functionalities. 

Before we show sample subclasses of JFrame, let’s first look at the following 
program which displays a default JFrame object on the screen: 



Chapter 14 Sample Program: Displays 
File: Chl4Defaul tj Frame, j ava 


default JFrame window 


*1 


i mpo 

rt j 

av 

a x 

. s wl 

ng 

* ' 




c 1 as 
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14 
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tJ 

F r a me { 




publ 

i c 

s 
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ma 1 n ( S t 
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ng [] args 



J F 

r a 

me d 

ef 

a u 1 t J 

F r a me ; 





de 

f a 

ul tJ 

Fr 

a me ■ 

= new j F 

r a 

me () ; 



de 

f a 

ul tJ 

Fr 

a me. : 

;et Vi si b 

1 e 

(true); 


} 

} 


{ 


When this program is executed, a default JFrame object, shown in Figure 14.5, 
appears on the screen. Since no methods (other than setVisible) to set the properties 
of the JFrame object (such as its title, location, and size) are called, a very small 
default JFrame object appears at the top left corner of the screen. 




You may not notice this 
frame window on the screen 
at first because it is so small. 
Look carefully at the top left 
corner of the screen. 


Figure 14.5 A default JFrame window appears at the top left corner of the screen. 
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extends 


Figure 14.6 


Now let’s define a subclass of the JFrame class and add some default charac¬ 
teristics. To define a subclass of another class, we declare the subclass with the 
reserved word xtends. So, to define a class named Ch14JFrameSubclass1 as a sub¬ 
class of JFrame, we declare the subclass as 

class Chl4J FrameSubcl assl extends JFrame { 

} 

For the Ch14JFrameSubclass1 class, we will add the following default charac¬ 
teristics: 

• The title is set to My First Subclass. 

• The program terminates when the Close box is clicked. 1 

• The size of the frame is set to 300 pixels wide and 200 pixels high. 

• The frame is positioned at screen coordinate (150, 250). 

The effect of these properties is illustrated in Figure 14.6. 

All these properties are set inside the default constructor. To set the frame’s 
title, we pass the title to the setTitle method. To set the frame’s size, we pass its width 
and height to the setSize method. To position the frame’s top left corner to the coordi¬ 
nate (x, y), we pass the values x and y to the setLocation method. Finally, to terminate 


+ x 


* *7 

250 

(150,250) 


150 

My First Subclass 1— ll^lEl 

200 


_J 

300 

Not drawn to scale 


Flow an instance of Ch14JFrameSubdass1 will appear on the screen. 


'if we don’t add this functionality, the window will close, but the program does not terminate. In a normal 
environment, we can still terminate the program by closing the command window, the one with the black 
background on the Windows platform. 
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the program when the frame is closed, we call the setDefaultCloseOperation with 
the class constant EXIT_ON_CLOSE as an argument. The Ch14JFrameSubclass1 class is 
declared as follows: 



Chapter 14 Sample Program: A simple subclass of JFrame 


File: Chl4J FrameSubcl assl. j ava 

*1 


import j avax. swi ng. *; 

class Chl4J FrameSubcl assl extends JFrame { 


private 

static 

final 

i nt 

FRAME 

Wl DTH 

= 300 

private 

static 

final 

i nt 

frame" 

HEI GHT 

= 200 

private 

static 

final 

i nt 

frame" 

X ORI Gl N 

= 150 

private 

static 

final 

i nt 

frame" 

Y"ORI Gl N 

= 250 


public Chl4J FrameSubcl assl ( ) { 


II set the fra me default properties 
s e t Ti11e (" My First Subclass"); 
setSI ze (FRAME Wl DTH, FRAME HE IGHT ); 
setLocation ( F RAME~ X_ ORI Gl N, F RA ME _ Y_ ORI Gl N) ; 


Calls the inherited 
methods. 


//register 'Exit upon closing' as a default close operation 

setDefaultCloseOperation! EXI T_0N_CL0SE ); 

} 

} 


Notice the methods such as setTitle, setSize, and others are all defined in the JFrame 
and its ancestor classes (ancestors are the superclasses in the inheritance hierarchy). 
Every method of a superclass is inherited by its subclass. Because the subclass- 
superclass relationships are formed into an inheritance hierarchy, a subclass inherits 
all methods defined in its ancestor classes. And we can call an inherited method 
from the method of a subclass in the manner identical to calling a method defined 
in the subclass, that is, without using dot notation or by using dot notation with the 
reserved word this. 



jiinqs to Remember 

Inherited methods are called from the method of a subclass without using dot 
notation or by using dot notation with the reserved word this. 
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Here’s the main class to test the Ch14JFrameSubclass1 class: 


Chapter 14 Sample Program: Displays a default Ch 14J F r a me S u be I a s s window 
Fi I e: Chl4Testj FrameSubcl ass.j ava 


class Chl4Testj Fra me Subclass { 

public static void mai n(Stri ng[] args) { 
Chl4J FrameSubcl assl my Fra me; 
my Fra me = new Chl4J FrameSubcl assl(); 
myFrame. setVi si bl e(true); 

} 

} 


When it is executed, an instance of Ch14JFrameSubclass1 appears on the screen, as 
illustrated in Figure 14.6. Notice this main class is identical to Ch14DefaultJFrame 
except for the creation of a Ch14JFrameSubclass1 instance instead of a JFrame in¬ 
stance. Also notice that there’s no need to import the javax.swing package because 
the main class does not make any direct reference to the classes in this package. 

Since we did not set the background colorfor Ch14JFrameSubclass1, the default 
white was used as the frame’s background color. (Note: If you see a different 
background color, such as gray, then most likely you are using an older version of 
Java, SDK 1.4 or earlier.) Let’s define another subclass named Ch14JFrameSubclass2 
that has a blue background color instead. We will define this class as an instantiable 
main class so we don’t have to define a separate main class. To make the background 
content pane appear in blue, we need to access the content pane of a frame. A frame’s content pane 
designates the area of the frame that excludes the title and menu bars and the border. 
It is the area we can use to display the content (text, image, etc.). We access the 
content pane of a frame by calling the frame’s getContentPane method. And to 
change the background color to blue, we call the content pane’s setBackground 
method. We carry out these operations in the private changeBkColor method of 
Ch14JFrameSubclass2. Here’s the class definition: 


/ * 

Chapter 14 Sample Program: A simple subclass of JFrame 

that changes the background 
color to blue. 
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File: Chl4J FrameSubcl ass2. j ava 

*1 

import javax.swing,*; 
i mport j ava. awt.*; 

class Chl4J FrameSubcl ass2 extends J F r a me { 


private 

static 

final 

i nt 

FRAME 

Wl DTH =30 0 

private 

static 

final 

i nt 

frame" 

HEI GHT =200 

private 

static 

final 

i nt 

frame" 

X 0RI Gl N = 150 

private 

static 

final 

i nt 

frame" 

Y" 0RI Gl N = 250 


public static void mai n(Stri ng[] args) { 

Chl4J FrameSubcl ass2 fra me = new Chl4J FrameSubcl ass2(); 
fra me. setVi si bl e(true); 

} 


public Chl4J FrameSubcl ass2() { 


II set the fra me default properties 
setTitle ("Blue Background (Frame Subcl 


setSi ze (FRAME Wl DTH, FRAME HE IGHT ); 
setLocation ( F RAME~X_ORI Gl N, F RAME_Y_ORI Gl 


ass"); 
N) ; 


//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 

changeBk Color)); 

} 


private void changeBkCol or() { 

Container contentPane = getContentPane () ; 
contentPane, setBackground(Col or. BLUE); 

} 

} 


Running the program will result in the frame shown in Figure 14.7 
appearing on the screen. Notice that we declare the variable contentPane in the 
changeBkColor method as Container. We do not have a class named ContentPane. 
By declaring the variable contentPane as Container, we can make it refer to any 
instance of the Container class or the descendant classes of Container. This makes 
our code more general because we are not tying the variable contentPane to any one 
specific class. By default, the getContentPane method of JFrame in fact returns the 
descendant class of Container called JPanel. We will describe the JPanel class in 
Section 14.5. 
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Figure 14.7 An instance of Ch14JFrameSubclass2 that has blue background. 

14.3 GUI Programming Basics 

In this section, we will develop a sample frame window that illustrates the funda¬ 
mentals of GUI programming. The sample frame window has two buttons labeled 
CANCEL and OK. When you click the CANCEL button, the window’s title is changed 
to You clicked CANCEL. Likewise, when you click the OK button, the window’s title 
is changed to You clicked OK. Figure 14.8 shows the window when it is first opened 
and after the CANCEL button is clicked. 

There are two key aspects involved in GUI programming. One is the place¬ 
ment of GUI objects on the content pane of a frame, and the other is the handling of 
events generated by these GUI objects. We will develop the sample program in two 
steps. First we will define a JFrame subclass called Ch14JButtonFrame to show how 
the two buttons labeled OK and CANCEL are placed on the frame. Then we will im¬ 
plement another subclass called Ch14JButtonEvents to show how the button events 
are processed to change the frame’s title. 

Button Placement 

pushbutton The type of button we use here is called a pushbutton. Since we discuss the push¬ 
buttons only in this chapter, we will simply call them buttons. To use a button in a 
program, we create an instance of the javax.swing. JButton class. We will create two 


Window title changes 
when the CANCEL button 
is clicked. 




Figure 14.8 A sample window when it is first opened and after the CANCEL button is clicked. 
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buttons and place them on the frame’s content pane in the constructor. Let’s name 
the two buttons cancelButton and okButton. We declare and create these buttons in 
the following manner: 

import javax.swing,*; 


layout 

manager 


absolute 

positioning 


J Button cancelButton, okButton; 

cancelButton = new] Button) 11 CANCEL"); 
okButton = new JButton("OK"); 

The text we pass to the constructor is the label of a button. After the buttons are cre¬ 
ated, we must place them on the frame’s content pane. 

There are two general approaches to placing buttons (and other types of GUI 
objects) on a frame’s content pane, one that uses a layout manager and another that 
does not. The ayoutmanager for a container is an object that controls the placement 
of the GUI objects. For example, the simplest layout manager called FlowLayout 
places GUI objects in the top-to-bottom, left-to-right order. If we do not use any lay¬ 
out manager, then we place GUI objects by explicitly specifying their position and 
size on the content pane. We call this approach absolute positioning. In this section, 
we will use FlowLayout. We will discuss other common layout managers and 
absolute positioning in Section 14.4. 

To use the flow layout, we set the layout manager of a frame’s content pane by 
passing an instance of FlowLayout to the setLayout method: 

content Pane, set Layout ( new FlowLayout))); 

After the layout manager is set, we add the two buttons to the content pane, so they 
become visible when the frame is displayed on the screen: 

content Pane. add(okButton); 
contentPane. add(cancel Button); 

Notice that the sizes of the OK and CANCEL buttons are different. The de¬ 
fault size of a button depends on the number of characters in the button’s label. We 
can override the default by calling the setSize method. For example, we can set their 
width to 80 pixels and height to 30 pixels by writing 

okButton. setSi ze(80, 30); 
cancel Button. setSi ze(80, 30); 

However, the setSize method does not take effect when the layout manager is used. 
It only works with absolute positioning. We won’t be using the setSize method here. 
We are now ready for the complete listing of the Ch14JButtonFrame class: 



Chapter 14 Sample Program: Displays a frame with two buttons 


File: Chl4J ButtonFrame.j ava 

*/ 
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import javax.swing,*; 
i mpor t j a va, a wt. *; 

class Chl4J ButtonFrame extends JFrame { 

private static final i nt FRAME_WI DTH = 3 0 0; 

private static final i nt FRAME_HEI GHT = 200; 

private static final i nt FRAME_X_ORIGl N = 150; 

private static final i nt FRAME_Y_ORI Gl N = 2 5 0; 

private J Button cancel Button; 
private j Button okButton; 

public static void main(5tri ng [ ] ar gs ) { 

Chl4J ButtonFrame fra me = new Chl4J ButtonFramef ) ; 
frame.setVi si bl e(true); 


public Chl4J ButtonFramef) { 

Container contentPane = getContent Panel ); 

II set the fra me properties 

setSize ( FRAME,Wl DTH, FRA ME _HE I GHT); 
s et Res i z a bl e ( f a I s e ) ; 

setTitle ("Program Chl4J ButtonFrame"); 
setLocati on ( FRA ME _X_ORIGl N, FRAME_Y_ORIGl N) ; 

II set the layout manager 

content Pane.set Layout ( new FlowLayout!)); 

II create and place two buttons on the frame's content pane 

okButton = new (Button! "OK"); 
content Pane. add(okButton) ; 

cancel Button = new) Button! "CANCEL"); 
content Pane. add(cancel Button); 

//register 'Exit upon closing' as a default close operation 

set Defaul tCI oseOperat i on( EXI T_ON_CLOSE) ; 

} 

} 


When we run the program, we see two buttons appear on the frame. We can click 
the buttons, but nothing happens, of course, because the code to handle the button 
clicks is not yet added to the class. We’ll add the required code next. 
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event 

delegation- 
based event 
model 

event source 


event listener 


action event 


Handling Button Events 

Now let’s study how we process the button clicks. An action such as clicking a but¬ 
ton is called an event, and the mechanism to process the events event handling. The 
event-handling model of Java is based on the concept known as the legation based 
event model. With this model, event handling is implemented by two types of 
objects: event source objects and event listener objects. 

A GUI object, such as a button, where the event occurs is called an event, or 
simply, the event source. We say an event source generates events. So, for example, 
when the user clicks on a button, the corresponding JButton object will generate an 
action event. When an event is generated, the system notifies the relevant event lis¬ 
tener objects. An event listener object, or simply an event listener, is an object that 
includes a method that gets executed in response to generated events. It is possible 
for a single object to be both an event source and an event listener. 

Among the many different types of events, the most common one is called an 
action event. For example, when a button is clicked or a menu item is selected, an 
event source will generate an action event. For the generated events to be processed, 
we must associate, or register, event listeners to the event sources. If the event 
sources have no registered listeners, then generated events are simply ignored (this 
is what happened in the Ch14JButtonFrame program). For each type of event, we 
have a corresponding listener. For example, we have action listeners for action 
events, window listeners for window events, mouse listeners for mouse events, and 
so forth. Event types other than action events are discussed later in this chapter. If 
we wish to process the action events generated by a button, then we must associate 
an action listener to the button. 

An object that can be registered as an action listener must be an instance of a 
class that is declared specifically for the puipose. We call such class an action lis¬ 
tener class. For this sample program, let’s name the action listener class Button- 
Handler. We will describe how to define the ButtonHandler class shortly. But first 
we will show the step to register an instance of ButtonHandler as the action listener 
of the two action event sources —okButton and cancelButton— of the sample frame 
window. 

An action listener is associated to an action event source by calling the event 
source’s addActionListener method with this action listener as its argument. For ex¬ 
ample, to register an instance of ButtonHandler as an action listener of okButton 
and cancelButton, we can execute the following code: 


ButtonHandler handler = new ButtonHandler) ); 

okButton. addActi onLi stenerf handl er); 
cancel Button. addActi onLi stenerf handl er); 

Notice that we are associating a single ButtonHandler object as an action 
listener of both buttons, because, although we can, it is not necessary to associate 
two separate listeners, one for the OK button and another for the CANCEL button. A 
single listener can be associated to multiple event sources. Likewise, although not 
frequently used, multiple listeners can be associated to a single event source. 
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hinqs to Remember 

A single listener can be associated to multiple event sources, and multiple listeners 
can be associated to a single event source. 


When an event source generates an event, the system checks for matching 
registered listeners (e.g., for action events the system looks for registered action 
listeners, for window events the system looks for registered window listeners, and 
so forth). If there is no matching listener, the event is ignored. If there is a matching 
listener, the system notifies the listener by calling the listener’s corresponding 
method. In case of action events, this method is actionPerformed. To ensure that the 
programmer includes the necessary actionPerformed method in the action listener 
class, the class must implement the ActionListener interface. The ButtonHandler 
class, for example, must be defined in the following way: 


import java, a wt. event.*; 
class ButtonHandler implements 


ActionListener is defined 
in this package. 

ActionLi st ener { 


} 


Remember that, unlike a class, a Java interface includes only constants and 
abstract methods. The java.awt.event.ActionListener, for instance, is defined as 


interface ActionListener { 

There's no method 

public void acti onPerformedjActi onEvent evt); 

method header. j 

The ButtonHandler class is defined as follows: 

class ButtonHandler implements ActionListener { 

II data members and constructors come here 
public void acti onPerformedjActi onEvent evt) { 

//event-handling state me n t s come here 

} 

} 

An argument to the actionPerformed method is an ActionEvent object that repre¬ 
sents an action event, and the ActionEvent class includes methods to access the 
properties of a generated event. 

We want to change the title of a frame to You clicked OK or You clicked CANCEL 
depending on which button is clicked. This is done inside the actionPerformed 
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method. The general idea of the method is as follows: 

public void acti onPerformed(Acti onEvent evt) { 

String buttonText 

= get the text of the event source; 

I F r a me f r a me 

= the fra me that contains this event source; 
frame. setTi tl e("You clicked " + buttonText); 

} 

The first statement retrieves the text of the event source (the text of the okButton is 
the string OK and the text of the cancelButton is the string CANCEL). We can do this 
in two ways. The first way is to use the getActionCommand method of the action 
event object evt. Using this method, we can retrieve the text of the clicked button as 

String buttonText = evt.get Act i onCommand( ); 

The second way is to use the getSource method of the action event object evt. 
Using this method, we can retrieve the text of the clicked button as 

Notice the typecast to an 
appropriate class is necessary. 

J Button cIi ckedBu11on = (JButton) evt.get Sour ce( ) ; 

String buttonText = cIi ckedBu11on.getText () ; 

Notice the typecasting of an object returned by the getSource method to JButton. 
The object returned by the getSource method can be an instance of any class, so we 
need to typecast the returned object to a proper class in order to use the desired 
method. 

Now, to find the frame that contains the event source, we proceed in two steps. 
First, we get the root pane to which this event source belongs. Second, we get the 
frame that contains this root pane. Here’s the necessary sequence of statements to 
access the frame that contains the event source: 

J Root Pane rootPane = cl i ckedButton. getRootPane( ); 

Fra me fra me = (JFrame) rootPane. getParent(); 

Typecasting is necessary 
he re, too. 

A frame window contains nested layers of panes (the content pane in which we 
place GUI objects is one of them). The topmost pane is called the root pane (an 
instance of JRootPane). We can access the root pane of a frame by calling the GUI 
object’s getRootPane method. From the root pane, we can access the frame object 
by calling the root pane’s getParent method. Because a root pane can be contained 
by different types of containers (frames, dialogs, etc.), we need to typecast the re¬ 
turned object to JFrame in this example. 
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Here’s the complete ButtonHandler class: 


Chapter 14 Sample Program: Event listener for button click events 
File: ButtonHandler.java 

*/ 

import javax.swing,*; 
i mpor t j a va. a wt. * ; 
import java,a wt.event.*; 

class ButtonHandler implements Acti onLi stener { 
public ButtonHandler)) { 

} 

public void acti onPerformed(Acti onEvent event) { 

J Button c I i ckedButton = ( J Button) event. getSource (); 

J RootPane rootPane = cl i ckedButton. getRootPane(); 

Fra me fra me = ( J F r a me ) rootPane, getParent(); 

String butt onText = cIi ckedBu11on,getText () ; 

frame.setTitle("You clicked " + buttonText); 

} 


And here’s the complete Ch14JButtonEvents class (notice that this class is 
essentially the same as the Ch14JButtonFrame class except for the portion that deals 
with the registration of a ButtonHandler to two event sources): 



Chapter 14 Sample Program: Displays a frame with two buttons 

and associates an instance of 
ButtonHandler to the two buttons 


File: Chl4J ButtonEvents. j ava 

*/ 

import javax.swing.*; 
i mpo r t j a v a, a wt. *; 

class Chl4J ButtonEvents extends JFrame { 

private static final i nt FRAME_WI DTH = 3 0 0; 
private static final i nt FRAME_HEI GHT = 200; 
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private static final i nt FRAME_X_ORI Gl N = 150; 

private static final i nt FRAME_Y_ORI Gl N = 250; 

private j Button cancel Button; 

private j Button okButt on; 

public static void mai n(Stri ng[] args) { 

Chl4J ButtonEvents fra me = new Chl4J ButtonEventsf ); 
fra me. setVi si bl e(true); 


public Chi4j ButtonEvents!) { 

Container contentPane = getContentPane ( ); 

II set the fra me properties 

setSize ( F R A M E _ Wl DT H, F RA ME _ HE I GHT) ; 

setResi zabl e (false); 

setTitle (“Program Chl4J ButtonFrame"); 
setLocation ( F RAME_ X_ ORI Gl N, FRAME_Y_ORI Gl N) ; 

II set the layout manager 

contentPane, set Layout ( new FI owLayout ()); 

II create and place two buttons on the frame's content pane 

okButton = new J Button! “OK"); 
contentPane, add(okButton); 

cancel Button = new) Button! "CANCEL"); 
contentPane, add( cancel Button); 

//registering a ButtonHandI er as an action listener of the 
II t wo buttons 

Bu11onHandI er handler = new Bu11onHandI er ( ); 
cancel Button,addActi onLi stenerfhandl er); 
okButton. addActi onLi stenerfhandl er); 

//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 

} 

} 


Making a Frame the Event Listener 

Instead of creating a separate event listener class such as ButtonHandler, it is actu¬ 
ally more common to let a frame be the event listener of the GUI objects it contains. 
We stated earlier that any class can implement the ActionListener interface. We can 
declare a subclass of JFrame that implements the ActionListener interface. As an 
illustration of this technique, let’s define a subclass of JFrame called Ch14JButton- 
FrameFlandler. This class combines the functionalities of the Ch14J Button Events 
and ButtonHandler classes. 
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Here’s the class: 



Chapter 14 Sample Program: Displays a frame with two buttons 

and handles the button events 


Fi I e: Ch14J ButtonFrameHandl er.j ava 

*/ 

import javax.swing,*; 
i mpor t j a va, a wt. *; 
import java,a wt.event.*; 

class Chl4J ButtonFrame Handler extends J F r a me implements ActionLi stener { 

private static final i nt FRAME_WI DTH = 3 0 0; 

private static final i nt FRAME_HEI GHT = 200; 

private static final i nt FRAME_X_ORIGl N = 150; 

private static final i nt FRAME_Y_ORI Gl N = 2 5 0; 

private j Button cancel Button; 
private j Button okButton; 

public static void mai n(Stri ng[] args) { 

C h14 J ButtonFra me Handler fra me = new C h14 J ButtonFra me Handler)); 
frame.setVi si bl e(true); 

} 


public Chl4J ButtonFrameHandl er( ) { 

Container contentPane = getContent Panel ); 

II set the fra me properties 

setSize ( FRAME, Wl DTH, F RA ME _ HE I GHT) ; 
s et Res I z a bl e( f a I s e) ; 

setTitle ("Program Chl4J ButtonFrameHandl er"); 
setLocati on ( FRA ME _X_ORIGl N, FRAME_Y_ORI Gl N) ; 

II set the layout manager 

content Pane.set Layout ( new FlowLayout(l); 

II create and place two buttons on the frame's content pane 

okButton = new J B u 11 o n (" O K" ) ; 
content Pane. add(okButton) ; 

cancel Button = new j Button! "CANCEL"); 
content Pane. add(cancel Button); 

//register this frame as an action listener of the two buttons 

cancel Button. addActl onLi stener(this); 
okButton. addActionLi stener(thi s); 
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//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 


} 


public void acti onPerformed(Acti onEvent event) { 

J Button cli ckedButton = (JButton) event. getSource( ); 


} 


String buttonText = clickedButton. getText(); 
setTitl e("You clicked " + buttonText); 


Calls the setTitle method 
of this frame object. 


Notice how we call the addActionListener method of cancelButton and okButton. 
This frame object is the action event listener, so we pass it as an argument to the 
method as 

cancel Button. addActi onLi stener(this); 
okButton. addActi onLi stener(this); 

Likewise, because the action Performed method now belongs to this frame class 
itself, we can call other methods of the frame class from the actionPerformed 
method without dot notation. So the statement to change the title is simply 

setTitle) "You clicked 11 + buttonText); 


F— 

Quick 

CHECK 

V 


L What is the purpose of a layout manager? 

Z Which object generates events? Which object processes events? 

3. A class that implements the ActionListener interface must implement which 
method? 

4 What does the getActionCommand method of the ActionEvent class return? 


14.4 


Text-Related GUI Components 


In this section we will introduce three Swing GUI classes— JLabel, JTextField, and 
JTextArea —that deal with text. The first two deal with a single line of text and the 
last with multiple lines of text. A TextField object allows the user to enter a single 
line of text, while a JLabel object is for displaying uneditable text. A JTextArea 
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object allows the user to enter multiple lines of text. It can also be used for display¬ 
ing multiple lines of uneditable text. 

Like a JButton object, an instance of JTextField generates an action event. A 
JTextField object generates an action event when the user presses the Enter key 
while the object is active (it is active when you see the vertical blinking line in it). 
JLabel, on the other hand, does not generate any event. A JTextArea object also gen¬ 
erates events, specifically the types of events called text events and document 
events. Handling of these events is more involved than handling action events, so to 
keep the discussion manageable, we won’t be processing the JTextArea events. 

We will describe the JTextField class first. We set a JTextField object’s size 
and position and register its action listener in the same way as we did for the 
JButton class. To illustrate its use, we will modify the Ch14JButtonFrameFlandler 
by adding a single JTextField object. We will call the new class Ch14TextFrame1. 
The effect of clicking the buttons CANCEL and OK is the same as before. If the user 
presses the Enter key while the JTextField object is active, then we will change the 
title to whatever text is entered in this JTextField object. In the data declaration 
part, we add 

JTextField i n p u t L i n e; 

and in the constructor we create a JTextField object and register the frame as its ac¬ 
tion listener: 


i c 

C 

hi 

4 T e x t F r a me 

1 { 


np 

ut 

Li 

ne = new j 

Text 

Fi el d 

np 

ut 

Li 

ne. s et Co 1 u 

mn s ( 

2 2); 

dd 

(i 

np 

ut Li ne); 



np 

ut 

Li 

ne, a ddAc t i 

o n L i 

st ene 


} 

Notice the use of setColumns method instead of setSize in the earlier examples. We 
do not use the setSize method to set the size of a text held. The number we pass to 
the setColumns method does not necessarily mean the number of characters visible 
on the text held because the default font may be a variable-pitch font. If we set the 
font to a fixed-pitch font as in 


i nputLi ne. setCol umns ( 20 ) ; 

i nputLi ne. setFont( new F o n t (" Courier", Font.PLAIN, 14)); 

then 20 characters will be visible. Also, notice that the setColumns method affects 
the number of characters visible by setting the size of the text held. It does not af¬ 
fect the number of characters we can enter in the text held. There is no hxed bound 
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instanceof 


on the number of characters we can enter. When we enter more than the visible 
number of characters, then the text will scroll to the left. 

Now we need to modify the actionPerformed method to handle both the but¬ 
ton click events and the Enter key events. We have three event sources (two buttons 
and one text field), so the first thing we must do in the actionPerformed method is 
to determine the source. We will use the instanceof operator to determine the class 
to which the event source belongs. Here’s the general idea: 

if ( event, get Sourc e () instanceof J Button) { 

//event source is either cancelButton 
II or okButton 

} else { //event source must be inputLine 

} 


We use the getText method of JTextField to retrieve the text that the user has 
entered. The complete method is written as 


public void actionPerformed)Acti onEvent event) { 


if ( event.get Sour ce( ) instanceof J Button) { 

J Button cl i ckedButton = ( J Button) event. getSource( ); 

String buttonText = clickedButton. getText(); 

setTitl e("You clicked 11 + buttonText); 


} else { II the event source is inputLine 
setTitl e("You entered 1 " + 

inputLine, ge t Text ( ) + 

} 


Notice that we can—but did not—write the else part as 

JTextField textField = (JTextField) event. get Sour ce( ) ; 
setTitle("You entered 1 " + textField. g e t T e x t ( ) + ); 

because we know that the event source is inputLine in the else part. So we wrote it 

more succinctly as 

setTi tl e("You entered 1 " + inputLine. g e t T e x t () + ); 

Another approach to event handling is to associate a ButtonHandler (defined 

in Section 14.3) to the two button event sources and a TextHandler (need to add this 
new class) to the text field event source. This approach is left as an exercise. 
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Here’s the complete Ch14TextFrame1 class: 



Chapter 14 Sample Program: Displays a frame with two buttons 

and one text field 


File: Chl4TextFramel.java 

*/ 


import javax.swing,*; 
i mpor t j a va, a wt. *; 
import java.a wt.event.*; 

class Chl4TextFramel extends JFrame implements Acti onLi stener { 


pr i vat e 

st at i c 

final 

i nt 

FRAME 

Wl DT H 

pr i vat e 

s t a t i c 

final 

i nt 

frame" 

HE 1GHT 

pr i vat e 

st at i c 

final 

i nt 

frame" 

X ORI Gl N 

pr i vat e 

st at i c 

final 

i nt 

frame" 

Y" OR 1 Gl N 


300 

200 

150 

250 


private j Button cancel Button; 
private j Button okButton; 


private JTextField inputLine; 


public static void mai n(Stri ng[] args) { 

Chl4Text Framel fra me = new Chl4TextFramel(); 
frame.setVisible(true); 

} 


public Chl4TextFramel() { 
Container contentPane; 


II set the fra me properties 

setSize ( F R A M E _ Wl DT H, F RA ME _ HE I GHT) ; 
s et Resi z a bl e( f a I s e) ; 

setTitle ("Program Chl4SecondJ Frame"); 
setLocati on ( F RAME_ X_ ORI Gl N, FRAME_Y_ORI Gl N) ; 

contentPane = getContent Panel ); 
contentPane.setLayout ( new FI owLayout ()) ; 

inputLine = new j Text Fi el d( ) ; 
i nputLi ne.setCol umns(22); 
content Pane. add(i nputLi ne); 

text field. 

i nputLi ne. addAct i onLi stener(this); 
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11 create and place two buttons on the frame 

okButt on = new j Button ("OK"); 
contentPane, add(okButton); 

cancel Button = new) Button ("CANCEL"); 
contentPane, add( cancel Button); 

//register this frame as an action listener of the two buttons 

cancel Button.addActi onLi stener (thi s) ; 
okButt on. addActi onLi stener(thi s); 

//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 


public void acti onPerformed(Acti onEvent event) { 

if ( event. getSource ( ) instanceof J Button) { 

JButton clickedButton = (J Button) event, getSource ( ); 

String buttonText = cli ckedButton. getText(); 
setTitle(“You clicked " + buttonText); 

} else { II the event source is inputLine 

setTitl e("You entered ' " + inputLine.g e t T e x t() + . ); 

} 

} 

} 


Now, let’s add a JLabel object to the frame. In the Ch14TextFrame1 class, we 
have one text field without any indication of what this text field is for. A JLabel 
object is useful in displaying a label that explains the purpose of the text field. Let’s 
modify the Ch14TextFrame1 class by placing the label Please enter your name 
above the inputLine text field. We will call the modified class Ch14TextFrame2. We 
add the data member declaration 

private JLabel prompt; 

and create the object and position it in the constructor as 

public Chl4TextFrame2 { 

prompt = new JLabel( ); 

prompt, s e t T e x t ( " PI ease enter your name"); 
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p r o mp t. s e t Si z e ( 1 5 0, 2 5 ); 
contentPane.add(prompt); 

} 

We can also set the text at the time of object creation as 

prompt = new J Label ("PI ease enter your name"); 

The JLabel class is not limited to the display of text. We can also use it to dis- 
imageicon playan image. To display an image, we pass an Imagelcon object when we create a 

JLabel object instead of a string. To create this Imagelcon object, we must specify 
the filename of an image. Notice that the program we are running, Ch14TextFrame2, 
and the image hie are placed in the same directory. We can place the image hie any¬ 
where we want, but the way we write the code here requires the image hie to be 
placed in the same directory. We keep it this way to keep the code simple. We add 
the data member declaration 

private JLabel image; 

and then create it in the constructor as 

public Chl4TextFrame2 { 

image = new J Label ( new lmagelcon("cat.gif")); 
i mage. setSi ze(50, 50); 
content Pane. add( i mage); 

} 

Figure 14.9 shows the frame that appears on the screen when the program is ex¬ 
ecuted. As the sample code shows, it is a simple matter to replace the image. All we 
have to do is to put the image we want in the right directory and refer to this image 
hie correctly when creating a new Imagelcon object. When we use a different image, 
we have to be careful, however, to adjust the width and height values in the setBounds 
method so the values will be large enough to display the complete image. 



Figure 14.9 The Ch14TextFrame2 window with one text JLabel, one image JLabel, one JTextField, and 

two JButton objects. 
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Here’s the Ch14TextFrame2 class (only the portion that is different from 
Ch14TextFrame1 is listed here): 



Chapter 14 Sample Program: Displays a frame with two buttons, 

one text field and two labels 


File: Chl4TextFrame2.java 

*1 

import j avax. swi ng, *; 
i mp o r t j a v a, a wt. *; 
import java,a wt.event.*; 

class Chl4TextFrame2 extends JFrame implements Acti onLi stener { 


private J Label prompt; 
private J Label image; 

public static void mai n(Stri ng[] args) { 

Chl4TextFrame2 fra me = new Chl4TextFrame2(); 
fra me, setVi si bl e(true); 


public Chl4TextFrame2() { 

Image = new JLabel(new lmagelcon("cat.glf")); 
i mage. setSi ze(50, 50); 
contentPane. add( i mage) ; 

prompt = new J Label ( ) ; 

prompt, s e t T e x t ( " PI ease enter your name"); 
pr ompt. s et Si z e ( 1 5 0, 2 5 ); 
contentPane, add(prompt); 


} 


} 


Now let’s create the third example by using a JTextArea object. We will call 
the sample class Ch14TextFrame3. In this sample program, we will add two buttons 
labeled ADD and CLEAR, one text held, and one text area to a frame. When a text is 
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JTextArea 


Figure 14.10 The state of a Ch14TextFrame3 window after six words are entered. 


entered in the text field and the Enter (Return) key is pressed or the ADD button is 
clicked, the entered text is added to the list shown in the text area. Figure 14.10 
shows the state of this frame after six words are entered. 

We declare a JTextArea object textArea in the data member section as 

private JTextArea textArea; 
and add the statements to create it inside the constructor as 


text 

Area 

= n 

ew j 

Text Areal ) 

text 

Area. 

set 

Col u 

mn s ( 2 2 ) ; 

text 

Area. 

set 

Ro ws 

(8); 

text 

Area. 

set 

Bo r d 

er ( 




Bor 

de r F ac t o r y 

text 

Area. 

set 

Edi t 

a b 1 e ( f a I s e 

c o nt 

ent P; 

a n e. 

a d d ( 

textArea); 


reateLi neBorder(Col or. RED)); 


By default, unlike the single-line JTextField, the rectangle that indicates the 
boundary of a JTextArea object is not displayed on the frame. We need to create 
the border for a JTextArea object explicitly. The easiest way to do so is to call 
one of the class methods of the BorderFactory class. In the example, we called the 
createLineBorder method with a Color object as its argument. We passed Color.RED 
so the red rectangle is displayed, as shown in Figure 14.10. The createLineBorder 
method returns a properly created Border object, and we pass this Border object to 
the setBorder method of the text area object. There are other interesting borders 
you might want to try. Table 14.2 lists other border types and the methods to cre¬ 
ate them. The API documentation of the BorderFactory class records more options 
and variations. 

In the sample frame, we do not want the user to edit the text displayed in the 
text area, so we disable editing by the statement 


textArea.set Editabl e(fal se); 
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Tahle 1 n j Border-creating methods of the j avax. s wi ng, BorderFactory class. 
‘ The listed methods are all class methods. 


Some Class Methods ofj avax. s wi ng. BorderFactory 


public static Border create E tchedBorder 

(java.awt.Color lineColor, java.awt.Color shadowColor) 
Creates an etched border with I i neCol or as line color and s h a d o wCo I or as 
shadow color. 

public static Border createLoweredBeveI Border () 

Creates a border with a lowered beveled edge with a bright shade of the GUI 
object's current background color for line and dark shading for shadow. This border 
is effective when you change the background color of the GUI object, 
public static Border createRai sedBevel Border!) 

Creates a border with a raised beveled edge with a bright shade of the GUI object's 
current background color for line and dark shading for shadow. This border is effec¬ 
tive when you change the background color of the GUI object, 
public static Border create Ti11 edBorder ( Stri ng title) 

Creates a default (etched) border with title displayed at the left corner of the 
border. 


To add a text to the text area, we use the append method. Notice that we can¬ 
not use the setText method of JTextArea here because it will replace the old content 
with the new text. What we want here is to add new text to the current content. Also, 
since we need to add new text on a separate line, we need to output the new-line 
control character \n. Here’s the basic idea for adding new text to the text area object 
text Area: 

String enteredText = i nputLi ne, getText ( ) ; 
textArea. append(enteredText + "\n" ) ; 

Because the actual sequence of characters to separate lines is dependent on the 
operating systems, if we want to maintain consistent behavior across all operating 
systems, it is best to not use a fixed character such as \n. Instead, we should call the 
getProperty method of the System class, passing the string line.separator as an 
argument, to get the actual sequence of characters used by the operating system on 
which the program is being executed. We can define a class constant as 

private static final String NEWLINE 

= System. getProperty!"I i ne. separator"); 

and use it in the program as 

textArea. appendfenteredText + NEWLINE); 
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Here’s the Ch14TextFrame3 class: 



Chapter 14 Sample Program: Displays a frame with two buttons, 

one text field, and one text area 


File: Chl4TextFrame3. j ava 

*/ 


import javax.swing,*; 
i mpor t j a va. a wt. *; 
import java.a wt.event.*; 


class Chl4TextFrame3 


extends JFrame implements Acti onLi stener { 


pr i vat e 
pr i vat e 
pr i vat e 
pr i vat e 

pr i vat e 
pr i vat e 


pr i vat e 
pr i vat e 
pr i vat e 
pr i vat e 


static 

f i 

nal 

i nt 

FRAME 

WIDTH 

300 

st at i c 

f i 

na 1 

i nt 

frame’ 

HEIGHT 

250 

st at i c 

f i 

nal 

i nt 

frame’ 

X ORI Gl N = 

150 

st at i c 

f i 

nal 

i nt 

frame’ 

Y’ORI Gl N = 

250 

static 

f i 

nal 

String EMPTY STRI NG 

_ II II 

static 

f i 

nal 

String NEWLI NE 



= System, get Property! " line, separator"): 

J Button cl earButton; 

j Button addButton; 

JTextField inputLine: 

J TextArea textArea; 


public static void mai n(Stri ng[] args) { 

Chl4Text Frame3 fra me = new Chl4TextFrame3(): 
frame.setVisible(true): 


public Chl4TextFrame3() { 

Container content Pane: 

II set the fra me properties 

setSize ( FRAME, Wl DTH, F RA ME _ HE I GHT) ; 
s et Resi z a bl e( f a I s e) ; 

setTitle ("Program Chl4TextFrame3"): 

set Locati on ( FRA ME _X_ORIGl N, F RAME_Y_ ORI Gl N) ; 

contentPane = getContent Panel ): 
contentPane. setLayout ( new FI owLayout ()); 

textArea = new JTextArea(); 
textArea. setCol umns(22); 
textArea. set Rows (8): 

textArea. setBorder( BorderFactory. createLi neBorder ( Col or. RED)): 
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textArea.set Editabl e(false); 
contentPane, add(textArea); 

inputLine = new JTextField(); 
i nput Li ne. setCol umns(22) ; 
contentPane, add(i nputLi ne); 

i nputLi ne. addActionLi stenerfthis); 

II create and place two buttons on the frame 

addButton = new J Button (“ADD"); 
contentPane. add(addButton) ; 

clearButton = new JButton (“CLEAR"); 
contentPane. add ( cl earButton) ; 

//register this frame as an action listener of the two buttons 

cl earButton. addActionLi stenerfthi s); 
addButton. addActionLi stener(thi s); 

//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 


public void acti onPerformed(Acti onEvent event) { 

if ( event. getSource ( ) instanceof JButton) { 

JButton clickedButton = (JButton) event, getSource ( ); 

if (cl ickedButton == addButton) { 
addText (i nputLi ne.getText(J); 

} else { 

cl e a r T e x t ( ); 

} 

} else { II the event source is inputLine 

addText(i nputLi ne. getText()); 

} 


private void addText ( Stri ng newline) { 
textArea. append(newl i ne + NEWLINE); 
i nputLi ne. s e t T e x t( ""); 


private void clearText() { 

t ext Ar ea. set Text(EMPTY STRI NG); 
i nput Li ne. setText(EMPTY STRI NG); 

} 

} 
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Figure 14.11 A sample Ch14TextFrame3 window when the JScrollPane GUI object is used. 

Using a JScrollPane to Add Scroll Bars Automatically 

When we run the Ch14TextFrame3 class and add more rows (lines) of text than 
the number of rows set by calling the setRows method, what happens? The height 
of the text area gets taller. Likewise, the text area expands horizontally when 
we enter a line longer than the specified width. This is not a desired behavior. The 
easiest way to handle the situation is to wrap the text area with an instance of 
JScrollPane javax.swing.JScrollPane that adds the vertical and horizontal scroll bars when 

necessary. 

In the original Ch14TextFrame3 class, this is what we did to create and set the 
JTextArea object: 

text Area = new JTextAreaf); 
textArea. setCol umns(22); 
textArea.set Rows!8) ; 
textArea.set Border( 

BorderFactory. createLi neBorder ( Col or. RED)); 
textArea.set Editabl e(false); 
contentPane. add(textArea); 

To add scroll bars that will appear automatically when needed, we replace the last 
statement above with the following: 

JScrollPane scrolI Text = new J ScroI I Pane ( textArea ); 
"wrapsaround" scrol I Text. setSi ze(200, 1 3 5 ); 

the text area. contentPane. a d d ( scrol I Text); 

Notice that the properties, such as the border and bounds, of the JScrollPane object 
are set, no longer the properties of the JTextArea. Figure 14.11 shows a sample 
Ch14TextFrame3 object when the JScrollPane class is used. 


W 

Quick 

CHECK 

V 


L What is the purpose of the instanceof operator? 

2. What user action will result in a JTextField object generating an action event? 

3. Does a JLabel object generate an event? 

4. What is the difference between textArea.setText ("Hello") and 
textArea.append ("Hello")? 
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14.5 Layout Managers 

We showed only a very simplistic use of FlowLayout manager in Section 14.3. In this 
section, we will explain the use of layout managers in greater detail by discussing 
three commonly used layout managers. In addition, we will describe absolute posi¬ 
tioning at the end of the section. 


C\\ou 

U Might 
Want to 

Know 


A benefit of using a layout manager is the automatic adjustment of GUI objects 
when their container (frame, dialog, applet, etc.) is resized. For example, if we place 
a JButton at the center of the container by using some layout manager, then this 
JButton will still be positioned at the center when the size of the container is 
changed.This automatic adjustment is important also when we consider running 
our program on different platforms, because by using a layout manager effectively 
we will get a more consistent look to our frames and dialogs across different plat¬ 
forms. With absolute positioning, a frame that looks nice on one platform may not 
appear as nice on another platform. 


FlowLayout The most basic layout is java.awt.FlowLayout. In using this layout, GUI com¬ 

ponents are placed in left-to-right order. When the component does not fit on the same 
line, left-to-right placement continues on the next line. As a default, components on 
each line are centered. When the frame containing the component is resized, the 
placement of components is adjusted accordingly. Figure 14.12 shows the placement 
of five buttons by using FlowLayout. 

Before we add any components, first we assign the desired layout manager to 
the container, in this case the content pane of a frame, in the frame’s constructor. 

Container contentPane = getContent Panel ) ; 

content Pane.set Layout ( new FlowLayout(l); 

A container has a default layout manager assigned to it, but it is always safer to 
explicitly assign the desired layout manager ourselves. After the layout manager is 
set, we create five buttons and add them to the content pane. 

JButton buttonl, butt o n 2, b u 11 o n 3, butt o n 4, b u 11 o n 5; 

buttonl = new] Buttonl "buttonl"); 

II do the same for other buttons 

contentPane, add(buttonl); 

content Pane. add(button2) ; 

II and so forth 
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Program Chl4FlowLayoutSample 


^LBjxJ 


button 1 

button 2 

button 3 



button 4 


button 5 


Center alignment is used 
as a default. It can be 
set to a different align¬ 
ment at the time a FlowLayout 
is created. 


When the frame first appears on the screen. 



After the frame's width is widened and shortened. 


Figure 14.12 Placement of five buttons by using FlowLayout when the frame is first opened and after the 
frame is resized. 


Notice the default is center alignment. We can change it to left or right align¬ 
ment as 

contentPane. setLayout( new FI owLayout ( FI owLayout. LEFT)); 
or 


contentPane. setLayout( new FI owLayo 
Here’s the complete sample code: 


owLayout. Rl GHT) ) ; 




Cha 

pt e r 

14 

S a mp 1 e P r 

ogram: Illustrates the use of FlowLayout 


Fi 1 

e: Ch 

14 F 

1 owLayout 

5 a mp 1 e. j ava 

*/ 






i mpo 

rt 

j avax 

. s wi n g. *; 


i mpo 

rt 

j ava. 

a wt 

* ' 
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class Chl4FI owLayoutSampI e extends JFrame { 


pri vat e 

st at i c 

final 

i nt 

FRAME 

Wl DTH = 3 0 0; 

pri vat e 

st at i c 

final 

i nt 

FRAME 

HE 1 GHT = 2 0 0; 

pri vat e 

s t a t i c 

final 

i nt 

FRAME 

X ORI Gl N = 150; 

pri vat e 

s t a t i c 

final 

i nt 

FRAME 

Y ORI Gl N = 2 5 0; 

Ma i n 

met hod 






public static void mai n(Stri ng[] args) { 

Chl4FI owLayoutSampI e frame = new Chl4FI owLayoutSampI e(); 
fra me. setVi si bl e(true); 


public Chl4FI owLayoutSampI e() { 

Cont ai ner cont ent Pane; 

J Button buttonl, b u 11 o n 2, butt o n 3, b u 11 o n 4, buttons; 

II set the fra me properties 

setSize ( F R A M E _ Wl DT H, F RA ME _ HE I GHT) ; 

setTitle ("Program Chl4FI owLayoutSampI e"); 
setLocati on( FRAME_X_ORI Gl N, FRAME_Y_ORI Gl N); 

contentPane = getContentPane ( ); 
contentPane, setBackground(Col or. WHITE); 
contentPane. set Layout ( new FI owLayout ()); 

II create and place four buttons on the content pane 


buttonl 

= new J Button( 

“button 

1"); 

b u 11 o n 2 

= new J Button( 

“button 

2“ ) ; 

b u 11 o n 3 

= new J Button( 

“button 

3"); 

b u 11 o n 4 

= new J Buttonl 

“button 

4“ ) ; 

buttons 

= new J Buttonl 

"button 

5"); 


contentPane, add(buttonl); 
contentPane. add( button2) ; 
contentPane. add(button3) ; 
contentPane, add ( bu11 on4 ) ; 
contentPane. add(button5) ; 

//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 

} 

} 
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When the frame first After the frame is resized, 

appears on the screen. 


IM'LnhUIr,,.-, 

UnJxJ 


button 1 


button 4 

button 5 

button 3 

button 2 


north 

west 

center 

east 

south 


Program Ch 14BorderLayoutSample 




Figure 14.13 Placement of five buttons by using BorderLayout when the frame is first opened and after the 
frame is resized. 


BorderLayout 


The second layout manager is java.awt.BorderLayout. This layout manager di¬ 
vides the container into five regions: center, north, south, east, and west. Figure 14.13 
shows five buttons placed in these five regions. The right frame in the figure is the state 
after it is resized. The north and south regions expand or shrink in height only, the east 
and west regions expand or shrink in width only, and the center region expands or 
shrinks on both height and width. Not all regions have to be occupied. Figure 14.14 
shows the frame with only the center and east regions occupied with buttons. 

We set the BorderLayout analogously as 

contentPane. setLayoutf new Border Layout ()); 


and then we place the GUI components, in this case, buttons, with the second argu¬ 
ment specifying the region. 


contentPane. add ( 
contentPane. add ( 
contentPane. add ( 
contentPane. add ( 
contentPane. add ( 


but 

o 

=3 

1— 1 

Bor 

de 

but 

t o n 2, 

Bor 

de 

but 

t o n 3, 

Bor 

de 

but 

t o n 4, 

Bor 

de 

but 

ton5, 

Bor 

de 


r Layout. NORTH) ; 
r Layout. SOUTH); 
r Layout. EAST); 
rLayout, WE ST); 
r Layout, CENTER); 


The BorderLayout used in Figures 14.13 and 14.14 has no gaps between the 
regions, which is the default. We can specify the amount of vertical and horizontal 
gaps between the regions in pixels. For example, to leave 10-pixel-wide gaps and 
20-pixel-high gaps between the regions, we create a BorderLayout object by pass¬ 
ing these values as arguments to the constructor. 


contentPane, set Layout ( new BorderLayout ( 10, 20)); 
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Figure 14.14 Placement of two buttons by using BorderLayout. Buttons are placed on the center and 
east regions. 


Here’s the complete sample program: 



Chapter 14 Sample Program: Illustrates the use of BorderLayout 


Fi le: Chl4BorderLayoutSampl e.j ava 

*/ 


import j avax. swi ng. *; 
i mpo r t j ava. a wt. *; 


class Chl4BorderLayoutSample extends JFrame { 


private static final int 
private static final int 
private static final int 
private static final int 


FRAME Wl DTH = 300 
frame’heiGHT = 200 
FRAME'X ORI Gl N = 150 
FRAME’y’ORI Gl N = 250 


II . 

II Ma i n met hod 


public static void mai n(Stri ng[] args) { 

Chl4BorderLayoutSample fra me = new Chl4BorderLayoutSample(); 
fra me. setVi si bl e(true); 


public Chl4BorderLayoutSample() { 

Cont ai ner cont ent Pane; 

J Button buttonl, b u 11 o n 2, butt o n 3, b u 11 o n 4, butt o n 5; 

II set the fra me properties 

setSize ( F R A ME _ Wl DTH, F RA ME _ HE I GHT) ; 
setTitle ("Program Chl4BorderLayoutSample"); 
setLocati on( FRAME_X_ORI Gl N, F RAME_ Y_ ORIGl N) ; 
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contentPane = getContent Panel ); 
contentPane. set Background! Col or. WHI TE); 
content Pane, set Layout ( new BorderLayout(J); 

//content Pane, set Layout ( new BorderLayout(/*hgap*/10, /*vgap*/10)); 
II create and place four buttons on the content pane 


buttonl 

= new J Buttonl 

"button 

l"); 

but t on2 

= new J Buttonl 

"button 

2" ) ; 

but t on3 

= new j Buttonl 

"button 

3"); 

b u 11 o n 4 

= new j Buttonl 

"button 

4" ) ; 

buttons 

= new j Buttonl 

"button 

5"); 


contentPane, add( buttonl, Border Layout. NORTH); 
contentPane, add( button2, Border Layout. SOUTH); 
content Pane. add( button3, BorderLayout. EAST); 
content Pane. add( button4, BorderLayout. WEST); 
content Pane. add( button5, BorderLayout.CENTER); 

//register 'Exit upon closing' as a default close operation 

setDefauI tCl oseOperat i on ( EXIT_ON_CLOSE ); 


The third layout manager is a va.awt.Grid Layout. This layout manager places 
GUI components on equal-size N X M grids. Figure 14.15 shows five buttons placed 
on 2 X 3 grids. Components are placed in top-to-bottom, left-to-right order. The 
frame on the right in Figure 14.15 is the state after it is resized. Notice the number of 
rows and columns remains the same, but the width and height of each region are 
changed. 

To create a GridLayout object, we pass two arguments: number of rows and 
number of columns. 

contentPane, set Layout ( new Gr idLayout ( 2, 3)); 

We then place GUI components in the manner analogous to the one used for 
FlowLayout. If the value provided for the number of rows is nonzero, then the value 
we specify for the number of columns is actually irrelevant. The layout will create 
the designated number of rows and adjust the number of columns so that all com¬ 
ponents will fit in the designated number of rows. For example, placing the five but¬ 
tons with any one of the following three statements will result in the same layout, 
namely, two rows of grids: 

contentPane, set Layout ( new Grid Layout ( 2, 0)); 
contentPane, set Layout ( new Grid Layout ( 2, 1)); 
contentPane, set Layout ( new Grid Layout ( 2, 5)); 
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When the frame first After the frame is resized, 

appears on the screen. 


Program Ch 14Gridl_ayoutSample JEHI 

button 1 

button 2 

button 3 

button 4 

button 5 



Program Ch 14GridLayoutSample 

-inlxlj 

button 1 

button 2 

button 3 

button 4 

button 5 



Figure 14.1 5 Placement of five buttons by using GridLayout of two rows and three columns when the 
frame is first opened and after the frame is resized. 


Here’s the complete program listing for Ch14GridLayoutSample: 



Chapter 14 Sample Program: Illustrates the use of GridLayout 


File: Chl4GridLayoutSampI e.j ava 

*1 

import j avax. swi ng. *; 
i mport j ava. awt.*; 

class Chl4Gri dLayoutSampI e extends JFrame { 

private static final i nt FRAME_WI DTH = 300 

private static final int FRAME_HEI GHT = 200 

private static final int FRAME_X_ORIGl N = 150 

private static final int FRAME_Y_ORIGl N = 250 


II . 

II Ma i n met hod 


public static void mai n(Stri ng[] args) { 

C h 14 G r i dLayoutSampI e frame = new Chl4Gri dLayoutSampI e(); 
fra me, setVi si bl e(true); 

} 
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public Chl4Gri dLayoutSampI e() { 

Container contentPane; 

JButton buttonl, butt o n 2, b u 11 o n 3, b u 11 o n 4, buttons; 

II set the fra me properties 

setSize ( F R A ME _ Wl DTH, F RAME_ HE I GHT ) ; 

setTitle ("Program Chl4Gri dLayoutSampI e"); 
set Locat i on( FRAME_X_ORI Gl N, F RAME_Y_ORI Gl N) ; 

contentPane = getContent Panel ); 

content Pane.set Background( Color. WHITE ); 

content Pane, set Layout ( new GridLayout(2,3)); 

II create and place four buttons on the content pane 


buttonl 

= new J Buttonl 

“button 

1"); 

but t on2 

= new J Buttonl 

“button 

2" ) ; 

but t on3 

= new J Buttonl 

“button 

3"); 

b u 11 o n 4 

= new j Buttonl 

"button 

4" ) ; 

buttons 

= new j Buttonl 

"button 

5"); 


contentPane. add(buttonl); 
content Pane. add(button2) ; 
content Pane. add(button3) ; 
content Pane. add( but ton4) ; 
content Pane. add(button5) ; 

//register 'Exit upon closing' as a default close operation 

setDefau I tCl oseOperat i on ( EXIT_ON_CLOSE ); 

} 

} 


It is possible not to use any layout manager. If we do not use one, then we 
place GUI objects on the frame’s content pane by explicitly specifying their posi- 
absolute tion and size. We call this approach absolute positioning. Although layout managers 

positioning are very useful in practical applications, knowing various layout managers is not 

indispensable for learning object-oriented and event-driven programming. So using 
absolute positioning is acceptable while learning object-oriented and event-driven 
programming. Keep in mind, however, that to build practical GUI-based Java pro¬ 
grams, we must learn how to use layout managers effectively. 

To use absolute positioning, we set the layout manager of a frame’s content 
pane to none by passing null to the setLayout method: 

cont ent Pane, set Layout ( null); 

After the layout manager is set to null, we place two buttons at the position and in 
the size we want by calling the button’s setBounds method as in 

okButton.setBounds(75, 125, 80, 30); 
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Container contentPane = getContentPane() ; 
JButton okButton = new JButton( "OK" ) ; 

contentPane. setLayout( nul I ) ; 
okButton. setBounds( 70, 125, 80, 30); 

contentPane. add(okButton) ; 


Program Ch14AbsolutePositioning [, ] 

(70,125) 

\ 

125 

70 

ok 30 

b—80—H 


Figure 14.1 6 This diagram illustrates the process of creating a button and placing it on a frame. 


where the first two arguments specify the position of the button and the last two 
arguments specify the width and height of the button. Finally, to make a button ap¬ 
pear on the frame, we need to add it to the content pane by calling the add method. 
For example, to add okButton, we call 

content Pane. add(okButton); 

Figure 14.16 illustrates the process. 

Here’s the program listing for Ch14AbsolutePositioning: 




Ch 

a pt er 

14 Sa 

mpl e 

P 

r o 

gram: S h o 

ws 

how t 

he 

a b s o 


Fi 

1 e: C 

h 14 A b s 

0 

1 ut 

eP 

os 

i t i t 

)ni ng. 

j a v 

a 



*/ 














i mp 

ort 

java 

x. s wi n 

9 

* . 









i mp 

ort 

java 

. a wt. * 

; 










c 1 a 

ss 

C h 14 A 

bsol ut 

e 

Pos 

i t 

i 0 

ni ng ext e 

nds 

j Fr a 

me 

{ 


pr 

i vat e 

st at i 

c 

f i 

na 

1 

i nt 

FRAME 

WI 

DTH 


= 300 


pr 

i vat e 

st at i 

c 

f i 

na 

1 

i nt 

FRAME 

"he 

1 GHT 


= 220 


pr 

i vat e 

st at i 

c 

f i 

na 

1 

i nt 

FRAME 

"x 

OR 1 Gl 

N 

= 150 


pr 

i vat e 

st at i 

c 

f i 

na 

1 

i nt 

FRAME 

"y" 

OR 1 Gl 

N 

= 250 
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private static final i nt BUTT0N_WI DTH = 80; 
private static final i nt BUTTON_HEI GHT = 30; 

private j Button cancel Button; 
private j Button okButton; 


II . 

II Mai n met hod 


public static void mai n(Stri ng[] args) { 

Chl4Absol utePositi oni ng fra me = new Chl4Absol utePositioni ng(); 
frame.setVisible(true); 


public Ch14AbsoI utePosi ti oni ng ( ) { 

Container contentPane = getContent Panel ) ; 

II set the fra me properties 

setSize ( FRAME, Wl DTH, F RA ME _ HE I GHT) ; 
s et Res i z a bl e ( f a I s e ) ; 

setTitle ("Program Chl4Absol utePositi oni ng"); 
set Locati on ( FRA ME _X_ORIGl N, FRAME_Y_ORI Gl N) ; 

II set the content pane properties 

contentPane.setLayout(null); 
contentPane, setBackground(Col or. WHI TE); 

II create and place two buttons on the frame's content pane 

okButton = new J B u 11 o n (" 0 K" ) ; 

okButton. setBounds( 7 0, 1 2 5, B UTTON_ Wl DTH, B UTTON_ HE IGHT ) ; 
content Pane, add(okButton); 

cancel Button = new] Button! "CANCEL"); 

cancel Button. setBoundsf 1 6 0, 1 2 5, BUTTON_WI DTH, B UTT ON_ H EI GHT ) ; 
content Pane. add(cancel Button); 

//register 'Exit upon closing' as a default close operation 

set Defaul tCI oseOperati on( EXI T_ON_CLOSE) ; 

} 

} 


W 

Quick 

CHECK 

V 


L How does the flow layout place the components? 

Z Which layout manager divides the container into grids of equal size? 
3. Write a statement to create a border layout with 20-pixel gaps in both 
horizontal and vertical directions. 
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14.6 Effective Use of Nested Panels 

In this section, we will discuss how to nest panels effectively to get a desired layout 
of GUI components. It is possible, but very difficult, to place all GUI components 
on a single JPanel or other types of containers. A better approach is to use multiple 
panels, placing panels inside other panels. To illustrate this technique, we will 
create two sample frames that contain nested panels. The first sample, shown in 
Figure 14.17, provides the user interface for playing Tic Tac Toe. And the second 
sample, shown in Figure 14.18, provides the user interface for playing HiLo. Note 
that we only illustrate the visual layout using nested panels. The sample frames do 
not include any code for actually playing the games. 

The frame shown in Figure 14.17 has four panels. The topmost JPanel, the 
content pane of the frame, has a border layout. The content pane’s center region is 


Program Chl4NestedPanelsl 


o 


X 






o 


o 


Player 1: 0 

Player 2: 0 


New Game 


Figure 14.1 7 A sample frame that contains nested panels. Four JPanel objects are used in this frame. 


^ Program Chl4NestedPai 


Your Guess 


-JS|x| 


Hint 


Let's Play HiLo 


Enter 

Cancel 



Figure 14.1 8 Another sample frame that contains nested panels. Five JPanel objects are used in this frame. 
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contentPane 



NORTH 


SOUTH 


CENTER 


EAST 


Figure 14.1 9 This diagram shows how the panels of the frame in Figure 14.17 are nested.There are 
four JPanel objects. We associate a border layout to both contentPane and controlPanel and a grid layout 
to scorePanel. The gamePanel is a specialized JPanel (it's a subclass of JPanel) that uses a grid layout. 


occupied by an instance of Ch14TicTacToePanel named gamePanel. Ch14TicTac- 
ToePanel is itself a nested panel. We will design and implement this panel at the end 
of this section. The content pane’s east region is occupied by an instance of another 
JPanel named controlPanel. A border layout is used for this panel. The north region 
of controlPanel is occupied by another JPanel named scorePanel, and the south re¬ 
gion is occupied by a JButton. The layout for scorePanel is set to a grid layout with 
four grids, each occupied by a JLabel object. The nesting relationship is shown in 
Figure 14.19. 

When we nest panels, it is often very useful to mark their borders. In this sam¬ 
ple frame, we use a titled border for scorePanel and a lowered bevel border for 
gamePanel. A titled border draws a rectangle around the panel and displays a desig¬ 
nated title. We create a titled border by calling the class method createTitledBorder 
of the BorderFactory class and assign to a panel by calling the setBorder method. 
Here’s the statement: 

scor ePanel.set Border ( 

BorderFactory. createTitl e d B o r d e r ( "Scores: ")); 

A lowered bevel border gives an illusion of the panel being recessed into the 
frame. Here’s the statement to create and set the lowered bevel border to gamePanel: 

ga me Panel. setBorder ( 

BorderFactory. createLoweredBevel Border! )) ; 
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Additional types of borders, such as line border, matte border, and raised bevel bor¬ 
der, are available. For more information, please consult the documentation for the 
BorderFactory class. 

Flere’s the complete listing of the program: 



Chapter 14 Sample Program: Illustrates the use of 

nested panels 

File: Chl4NestedPanelsl.java 

*1 

import j avax. swi ng. *; 
i mpo r t j a v a. a wt. *; 

class Chl4NestedPanelsl extends JFrame { 


private 

static 

f i 

nal 

i nt 

FRAME 

Wl DTH =50 0 

private 

static 

f i 

nal 

i nt 

frame" 

HEI GHT =350 

private 

static 

f i 

nal 

i nt 

frame" 

X ORI Gl N = 150 

private 

static 

f i 

nal 

i nt 

frame" 

Y" ORI Gl N = 250 

public 

st at i c 

voi 

d ma i n ( S t r i n g [ ] a r g s ) { 


Chl4NestedPanelsl frame = new Chl4Nest edPanel sl( ) ; 
fra me. setVi si bl e(true); 

} 


public Chl4NestedPanelsl() { 

Container contentPane; 

Chl4TicTacToePanel g a me Panel; 
JPanel controlPanel; 

JPanel scorePanel; 


II set the fra me properties 

setSize ( F R A M E _ Wl DT H, F RA ME _ HE I GHT) ; 
setTitle ("Program Chl4NestedPanel si"); 
setLocati on( FRAME_X_ORI Gl N, F RAME_Y_ ORI Gl N); 


contentPane = getContentPane ( ); 

contentPane, set Layout ( new BorderLayout ( 10, 0)); 

g a me Panel = new Chl4TicTacToePanel(); 

g a me Panel . setBorder( BorderFactory. createLoweredBevel Border(l); 
controlPanel = new J Panel ( ) ; 
controI PaneI . setLayout ( new BorderLayout ( )); 

contentPane, a d d ( g a me Panel , BorderLayout. CENTER); 
contentPane, addfcontrol Panel, BorderLayout. EAST); 

scorePanel = new J Panel ( ) ; 

scorePanel . set Border! BorderFactory.createTitI edBorder( "Scores: ")) ; 
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scorePanel . setLayout( new Gri dLayout(2, 2)); 
scorePanel . add( new J Label ("PI ayer 1:“)); 
scorePanel . add( new J Label ( " 0“)); 

scorePanel . add( new J Label ("PI ayer 2:")); 
scorePanel . add( new J Label ( " O' 1 )); 

control Panel. add(scorePanel, BorderLayout. NORTH); 

control Panel, add ( new J Button! “New Game"), BorderLayout. SOUTH); 

//register 'Exit upon closing' as a default close operation 

set Defaul tCI oseOperat i on( EXI T_ON_CLOSE) ; 

} 

} 


Remember that this class illustrates only the visual aspect of the program. 
There is no code for handling events or actually playing the game. 

Now let’s move on to the second sample frame. For this frame, we will use 
nested panels shown in Figure 14.20. Notice the panel that has a BorderLayout. This 
panel seems extra, but without it, the buttons will appear away from the bottom, 
closer to the response label. We feel it is more appealing visually when the buttons 
are placed at the bottom. 


HiLoDisplay 



Figure 14.20 The nested panels and associated layout managers for HiLoDisplay. 
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Here’s the Ch14NestedPanels2 class: 



Chapter 14 S a mp I e Program: Illustration of Nested Panels 


File: Chl4NestedPanels2.j ava 

*/ 

import j avax. swi ng, *; 
i mpo r t j ava. a wt. *; 

class Chl4NestedPanels2 extends JFrame { 


private 

static 

final 

int FRAME 

Wl DTH 

= 250 

private 

static 

final 

i nt FRAME’ 

HEI GHT 

= 270 

private 

static 

final 

int FRAME’ 

X ORI Gl N 

= 150 

private 

static 

final 

int FRAMER 

y|ORI Gl N 

= 250 

private 

final 

String 

ENTER = 1 

Enter"; 


private 

final 

String 

CANCEL = 1 

Cancel " ; 


private 

final 

String 

BLANK = 1 

" i 


private 

JTextField guessEntry; 



private 

j Label 

hint; 




public static void main(String[] args) { 

Chl4NestedPanels2 frame = new Chl4Nest edPanel s2( ) ; 
fra me. setVi si bl e(true); 

} 

public Chl4NestedPanels2() { 

JPanel guessPanel, hintPanel, 

control Panel, buttonPanel; 

J Button enterBtn, cancel Btn; 

Cont ai ner cont ent Pane; 

II set the fra me properties 

setSize ( F R A ME _ Wl DTH, F RA ME _ HE I GHT) ; 

setTitle ("Program Chl4NestedPanels2“); 
setLocati on( FRAME_X_ORI Gl N, FRAME_Y_ORI Gl N); 

contentPane = getContentPane (); 

contentPane, set Layout ( new Gr i dLayout ( 3, 1)); 

guessPanel = new j Panel)); 

guessPanel.set Border( BorderFactory. createTi tl e d B o r d e r ( 

"Your Guess")); 

guessPaneI ,add ( guessEntry = new j TextFi eI d ( 10 ) ); 
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hintPanel = new J Panel ( ) ; 

hi ntPanel.setBorder(BorderFactory.createTitl edBorder(“Hi nt")); 
hintPanel ,add(hint = new J Label ( " Let's Play Hi L o" ) ) ; 

control Panel = new J Panel (new BorderLayout()); 
buttonPanel = new JPanel(); 

buttonPanel.ad d ( enterBtn = new j Butt on( ENTER) ); 
buttonPaneI . add ( canceI Btn = new J Butt on( CANCEL) ) ; 
control Panel. add( butt onPanel , Bor der Layout. SOUTH); 

content Pane.add(guessPanel ) ; 
contentPane.add(hi ntPanel ); 
content Pane. add(control Panel ); 

} 

} 


TicTacToe Panel 

As promised, let’s design and implement a panel specialized in displaying the Tic 
Tac Toe board of N X N = N 2 cells (default is 3 X 3 = 9 cells). Figure 14.17 shows 
this Tic Tac Toe panel placed on a frame. The panel handles the mouse click events, 
so every time the player clicks on the cell, the circle or cross is displayed. However, 
this code for handling mouse click events is only for demonstration. There’s no 
logic of actually playing the game of Tic Tac Toe. For instance, when we click on 
the cell that already has a cross or circle, a new mark replaces the current one. In the 
real game, this should not happen. The demonstration code simply alternates be¬ 
tween the cross and circle. When we click the panel for the first time, the circle is 
placed, then the cross, then the circle, and so forth. 

How shall we implement this panel? There are two approaches. The first ap¬ 
proach is to compute the origin point—the top left corner—of each cell based on 
the dimension of the panel and the number of cells in the panel. When we know the 
origin point of a cell, then we can draw a circle or cross by using the drawLine and 
drawOval methods. Figure 14.21 illustrates how this is done. When a cell is 
clicked, we get the x and y coordinates of the mouse click location and determine 
in which cell the mouse click event has occurred. Once we know the cell, we use 
its origin point to draw a circle or cross at the correct position and size. This 
approach requires a fair amount of coding to determine the cell and the correct 
position to draw lines and circles. We can avoid all these computations by using the 
second approach. 

The second approach, the one which we will adopt here, uses the nested pan¬ 
els. We will define two classes— Ch14TicTacToePanel and Ch14TicTacToeCell —both 
subclasses of JPanel. An instance of Ch14TicTacToePanel will contain N 2 instances 
of Ch14TicTacToeCell, each instance representing a single cell in the Tic Tac Toe 
board. A Ch14TicTacToeCell object contains one component, namely, an instance of 
JLabel. Instead of a text, we assign an image icon to this JLabel object. We have 
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— W/3 - 


\ 

(0,0) 

\ 

(VK/3,0) 

\ 

(2W/3,0) 


\ 

(O.tf/3) 

X 

\ 

(2W/3,H/3) 

H 

\ 

(0,2H/3) 

\ 

(W/3,2H/3) 

o 


- w - 



How the origin point for each cell 
is computed. 


(C x ,C y ) [for example (C x ,C y ) = (2W/3, 2H/3)] 



g.drawOval(C, + CJ 4, C y + CJ 4, Cj 2, CJ 2); 


How a circle (an oval if W != H) is 
drawn in a cell. 


Figure 14.21 The approach not adopted here.This approach is left as Exercise 14.The panel is divided 
into equal-size cells. A circle or cross can be drawn by using the drawOval or drawLine method at the 
position slightly offset from the origin point of the cell. 


three image files: the first one for the circle, the second for the cross, and the last one 
for a blank cell. These hies are named circle.gif, cross.gif, and blank.gif, respec¬ 
tively. All three images have a transparent background so the background color 
of the Ch14TicTacToeCell will be visible. Notice that these image hies must be put 
in the same folder as the class hies Ch14TicTacToePanel.class and Ch14TicTac- 
ToeCell.class. Initially, all cells are assigned the blank.gif image. And we set a line 
border for each cell so the boundary lines are visible. Without such boundary lines, 
we wouldn’t be able to tell how many cells the board had and where each cell began 
and ended. When a cell is clicked, Ch14TicTacToePanel will set it to a cross or a circle 
by calling the cell’s setContent method. 

The class includes one data member called location, a Point object, to record 
the cell’s position on the Tic Tac Toe board. This information is not used in this sam¬ 
ple. We need to process the location information when we develop the complete Tic 
Tac Toe playing program. 

Here’s the complete listing of the Ch14TicTacToeCell class: 


Chapt 

er 14 Sample Program: 

Tic Tac Toe 

File: 

Chl4Ti cTacToeCel1.j a 

va 

*1 



i mp o r t j 

a va. a wt. *; 


i mp o r t j 

a va x. swi ng. *; 


public c 

lass Ch 14Ti cTacToeCel 

1 extends JPanel { 

publ 

ic static enumlmage 

{BLANK, Cl RCLE, CROSS} 
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pr i vat e 

st at i c 

final 

St r i 

ng 

CROSS 

1 MAGE 

FILE = 

“cross, gi f " 

private 

static 

final 

St r i 

ng 

Cl RCLE 

1 MAGE 

FI LE = 

“circle.gif 

private 

static 

final 

St r i 

ng 

BLANK 

1 MAGE 

FILE = 

“blank.gif" 

pr i vat e 

j Label 

content; 






pr i vat e 

Poi nt 

1 oc at i 

on; 







public C h 1 4 T i cTacToeCelI ( ) { 

t hi s( nul I ); 

} 


public Chl4Ti cTacToeCelI ( Poi nt pt) { 

Imagelcon initlmage = new I magel con("bl ank. gi f"); 

set Layout ( new BorderLayout ()) ; 
setBackground(Col or.whi te); 

set Border ( BorderFactory. createLi neBorder(Col or. BLACK) ); 


content = new JLabel(initlmage); 
add(content); 


location = pt; 

} 


public Point getPositi on( ) { 
return location; 

} 


} 


publ 


} 


ic void setContent( I mage image) { 
swi t c h ( i mage) { 

case CIRCLE: content, setl con(new 

break; 

case CROSS: content, setl con( new 

break; 


def a ul t 


} 


II do nothing 

break; 


I magel con( Cl RCLEJ MA G E _ FI LE)) ; 
I magel con( CROSS_l MAGE_FI LE) ); 


The main tasks for the Ch14TicTacToePanel to handle are the layout of N 2 
Ch14TicTacToeCell objects and the mouse click events. Since the board is divided 
into equal-size cells, the grid layout is the perfect layout manager to use here. By 
using the grid layout manager, the images will stay at the center of the cells even 
when the panel is resized. 
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Each cell is the source of mouse events, and the container of these cells, that 
is, an instance of Ch14TicTacToePanel. is designated as the listener of the mouse 
events. Again, the event-handling code for this class is temporary. We will set an 
image of a circle or a cross to the clicked cell. There’s no logic here to actually play 
the game, for example, to determine the winner. Here’s the complete listing of the 
Ch14TicTacToePanel class: 


/ * 

Chapter 14 Sample Program: Tic Tac Toe Board 
File: Chl4Ti cTacToePanel.j ava 

*/ 

i mpo r t j ava. a wt. *; 
import j avax. swi ng. *; 
import java.a wt.event.*; 

public class Chl4Ti cTacToePanel extends JPanel implements MouseLi stener { 

private boolean circle; 

public Chl4Ti cTacToePanel ( ) { 
t hi s ( 3 ); 

} 

public Ch14Ti cTacToe PaneI ( int size) { 

C h14 Ti cTacToeCelI cell; 

set Layout ( new Gri dLayout ( si ze, size)); 

for ( i nt row = 0; row < size; row++) { 

for ( i nt col = 0; col < s I z e; c o I ++) { 
cell = new Ch14TicTacToeCeI I ( ); 

cel I .addMouseLi stenerfthi s); 
a d d ( cel I ) ; 

} 

} 

circle = true; 

} 

public void moused i cked(MouseEvent event) { 

Chl4Ti cTacToeCelI cell = (Chl4Ti cTacToeCelI ) event.get Sour ce( ) ; 
if (circle) { 

cel I . set Cont ent ( Chl4Ti cTacToeCelI. I mage. Cl RCLE); 

} else { 

cel I . set Cont ent ( Chl4Ti cTacToeCel I . I mage. CROSS); 

} 
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circle = ! ci r cl e; 

} 


} 


public void mouseEntered ( MouseEvent event) 

public void mouseExited (MouseEvent event) 

public void mousePressed (MouseEvent event) 

public void mouseRe I eased ( MouseEvent event) 


{ } 
{ } 
{ } 
{ } 


14.7 Other GUI Components 

We will introduce other useful Swing components in this section. Please keep in 
mind that we limit the discussion to the most basic use of these components. They 
are actually far more capable than what we present here. However, the materials 
presented in this section should be enough to let you use them in most common sit¬ 
uations and should serve as a good starting point from which you can explore more 
advanced uses of these components on your own. 

JCheckBox 

The JButton class represents a type of button called a pushbutton. Two other com¬ 
mon types of buttons are called check-box and radio buttons. We will explain the 
check-box buttons in this subsection and the radio buttons in the next subsection. 

The JCheckBox class is used to represent check-box buttons. Figure 14.22 
shows a frame with four check-box buttons and one pushbutton. Check-box buttons 
are useful in presenting a collection of binary (yes/no, true/false) options. The frame 
shown in Figure 14.22 gives the user the option to select the programming lan¬ 
guages he or she can program with by clicking on the appropriate check-box button. 

We deal with the JCheckBox class in a manner very similar to that for the 
JButton class. To create a check-box button with a text Java, we write 

JCheckBox cbBtn = new JCheckBox!“Java"); 


jpts Program Chl4JCheckBoKSamplel 





Program Chl4JCheckBoxSamplel 


Can Program In 
E Java 

□ C++ 

12 Smalltalk 

□ Ada 


OK 


The state when the frame first appeared 
on the screen. 


The state after the two check-box buttons 
are clicked. 


Figure 14.22 A frame with four check-box buttons and one pushbutton. 
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To check if a check-box button is selected (i.e., has a check mark) or deselected, we 
call its isSelected method. For example, 

if ( c bBt n.i s Sel ec t ed( )) { 

System, out. pri ntl n("You can program in" 

+ cbBtn.getText(J); 


} else { 

System, out. pri ntl n("You cannot program 

+ c bBtn.get Text 


} 


i n 11 

0 ); 


Just as with a pushbutton, we can retrieve the text associated to a check-box button 
by calling its getText method. We can use the corresponding setText method to 
change the button text. 

The following Ch14JCheckBoxSample1 class displays the frame shown in 
Figure 14.22. When the OK pushbutton is clicked, we respond by opening a mes¬ 
sage dialog with a list of selected programming languages. In the program, notice 
the use of an array of string btnText in creating an array of JCheckBox buttons. We 
can easily list any number of names by simply including all names when btnText is 
initialized, for example, 

String!] btnText = {“Java", "C++", "Smalltalk", "Ada", 

"COBOL", "AI gol", “Pascal “, "BASI C" }; 

There’s no need to modify the program code. The ease of achieving this generality 
is a direct benefit of using panels and layout managers instead of absolute position¬ 
ing. (You still can do it, but it would be a lot more tedious work to code the same 
capability with absolute positioning.) 

Here’s the class: 


Chapter 14 Sample Program: Illustrates the use of JCheckBox 
File: Chl4J CheckBoxSampI el.j ava 

*/ 

import javax. swing,*; 
i mpor t j a va. a wt. *; 
import java.a wt.event.*; 

class Chl4J CheckBoxSampI el extends JFrame implements Acti onLi stener { 

private static final i nt FRAME_WI DTH = 3 0 0; 

private static final int FRAME_HEI GHT = 200; 

private static final int FRAME_X_0RIGl N = 150; 

private static final int FRAME_Y_0RIGl N = 250; 
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private JCheckBox[] checkBox; 

public static void mai n(Stri ng[] args) { 

Chl4J CheckBoxSampI el frame = new Chl4J CheckBoxSampI el( ); 
fra me. setVi si bl e(true); 


public Chl4J CheckBoxSampI el( ) { 

Cont ai ner cont ent Pane; 

JPanel checkPanel, okPanel; 

JButton okButt on; 

String!] btnText = {"java", "C ++", "Smalltalk", "Ada"}; 

II set the fra me properties 

setSIze ( F R A M E _ Wl DT H, F RA ME _ HE I GHT) ; 

setTitle ("Program Chl4J CheckBoxSampI el"); 
set Locati on( FRAME_X_ ORI Gl N, FRAME_Y_ORI Gl N) ; 

contentPane = getContentPane ( ); 
contentPane. set Background! Col or. WHITE); 
contentPane. set Layout ( new Border Layout ()); 

II create and place four check boxes 

checkPanel = new J Panel ( new GridLayout(0,l)); 
checkPanel.setBorder(BorderFactory.createTitl edBorderf 

"Can Program In")); 

checkBox = new j CheckBox [ btnText.I engt h]; 

for ( i nt i = 0; i < checkBox. I ength ; i ++) { 
checkBox[l] = new J CheckBox(btnText[i ]); 
checkPanel .add(checkBox[i ]); 

} 

II create and place the OK button 

okPanel = new J Panel (new FlowLayout(l); 
okButt on = new j Button) "OK"); 
okButt on. addActi onLi stener (thi s) ; 
okPanel. add(okButton); 

contentPane, add( checkPanel, Border Layout. CENTER); 
contentPane. add( okPanel, Bor der Layout. SOUTH); 

//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 


public void acti onPerformed(Acti onEvent event) { 

Stri ngBuffer skill = new Stri ngBuffer( "You can program i n\n" ); 
for ( i nt i = 0; i < checkBox.I ength; i ++) { 
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} 


if (checkBox[i ].i sSel ectedf) ) { 

skill. append(checkBox[i].getText() + 11 \ n “); 

} 


j Opti onPane. showMessageDi al o g ( t h i s , ski I I.toStri n g () ) ; 


Although we did not process them in the Ch14JCheckBoxSample1 program, a 
JCheckBox object generates action events just as any other buttons do. So we can as¬ 
sociate an action listener to JCheckBox objects, but it is not that common to process 
action events generated by JCheckBox objects. In addition, a JCheckBox object gen- 
item events erates another type of event called item events. An item event is generated when the 
state (selected or deselected) of a check-box button changes. We can register an in¬ 
stance of a class that implements the ItemListener interface as an item listener of a 
JCheckBox object. When an item event is generated, its itemStateChanged method 
is called. Inside the method, we can check the state of change by calling the get- 
StateChange method. Here’s a sample itemStateChanged method: 

public void i temStateChanged( I temEvent event) { 

if ( event. get St at eChange( ) == I temEvent. SELECTED) { 
System, out. pri ntl n("You checked the box"); 

} else { 

System, out. pri ntl n("You unchecked the box"); 

} 

} 

Here’s the Ch14JCheckBoxSample2 class that adds the item event handling 
to the Ch14JCheckBoxSample1 class: 


Chapter 14 Sample Program: Illustrates the use of JCheckBox 
File: Chl4J CheckBoxSampI e2.j ava 

*/ 

import javax.swing,*; 
i mpor t j a va. a wt. *; 
import java.a wt.event.*; 

class Chl4J CheckBoxSampI e2 extends J Fra me 

implements Acti onLi stener, 

I temLi stener { 


www.it-ebooks.info 




14.7 Other GUI Components 843 


private static final 
private static final 
private static final 
private static final 


i nt FRAME Wl DTH = 300 
i nt FRAME'HEI GHT = 200 
i nt FRAME'X ORI Gl N = 150 
i nt FRAME’y’ORI Gl N = 250 


private JCheckBox[] checkBox; 


public static void mai n(Stri ng[] args) { 

Chl4J CheckBoxSampI e2 frame = new Chl4J CheckBoxSampI e2( ); 
fra me. setVi si bl e(true); 

} 


public Chl4J CheckBoxSampI e2( ) { 

Cont ai ner cont ent Pane; 

JPanel checkPanel, okPanel; 

J Button okButt on; 

String!] btnText = {"Java", "C ++", "Smalltalk", "Ada"}; 

II set the fra me properties 

setSize ( F RAME_ Wl DTH, F RA ME _ HE I GHT) ; 
setTitle ("Program Chl4J CheckBoxSampI e2"); 
set Locati on( FRAME_X_ORI Gl N, FRAME_Y_ORI Gl N) ; 

contentPane = getContentPane ( ); 
contentPane. set Background! Col or. WHITE); 
contentPane. set Layout ( new Border Layout ()); 

II create and place four check boxes 

checkPanel = new J Panel ( new GridLayout(0,l)); 
checkPanel,setBorder(BorderFactory.createTitl edBorderf 

"Can Program In")); 

checkBox = new j CheckBox [ btnText.I engt h]; 

for ( i nt i = 0; i < checkBox. I ength ; i ++) { 
checkBox[i] = new j CheckBox ( btnText [I]); 
checkPanel. add(checkBox[i ]); 

checkBox[i ]. addltemLi stener(thi s); 

} 

II create and place the OK button 

okPanel = new J Panel (new FlowLayout(l); 
okButt on = new J Button)"OK"); 
okButton.addActi onLi stener(this); 
okPanel. add(okButton); 

contentPane. add( checkPanel, Border Layout. CENTER); 
contentPane, add( okPanel, Bor der Layout. SOUTH); 

//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 
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for 


} 


i f 
} 


nEvent ev 

ent ) 

{ 

ngBuf f er ( 

"You 

can program 

length; i 

++) 

{ 

d ()) { 



[ i ] .get Te 

xt () 

+ " \n "); 


} 


j Opti onPane. showMessageDi al og(this, ski I I. toStri ng() ) 


{ 


public void i t emSt at eChanged( I temEvent event 

J CheckBox source = (J CheckBox) event.get Source() ; 
String state; 

if ( event. get St at eChange) ) == I temEvent. SELECTED) { 
state = "is selected"; 

} else { 

state = "is deselected"; 

} 

J Opti onPane. showMessageDi al og(thi s, "J CheckBox + 

sour ce,get Text () + 
. + s t a t e ) ; 


JRadioButton 

The JRadioButton class is used to represent a type of button called a radio button. 
Similar to a check-box button, you can select or deselect a radio button. But unlike 
with a check-box button, you can only select one of the radio buttons that belong to 
the same group. Figure 14.23 shows a frame with four radio buttons and one push¬ 
button. We can select exactly one of the four radio buttons at a time because they be¬ 
long to the same group. When we select a new one, then the currently selected radio 
button will get deselected. Radio buttons are useful in allowing the user to select 
one from a list of possible choices. The sample frame in Figure 14.23 allows the 
user to select the favorite programming language. 

We can use the JRadioButton class in almost an identical manner as that for 
the JCheckBox class. Like JCheckBox, JRadioButton generates both action events 
and item events. The key difference is the requirement to add JRadioButton objects 
to a button group, in addition to adding them to a container. Notice that the addition 
of radio buttons to a group is a logical operation (only one radio button in a group 
can be selected at a time), and the addition of radio buttons to a container is a visual 
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(• Java 


O C++ 


C Smalltalk 


O Ada 


OK 




The state when the frame first appeared The state after the third radio button is clicked, 

on the screen. Previous selection gets deselected. 


Figure 14.23 A frame with four radio buttons and one pushbutton. 


layout operation. Here’s a portion that creates radio buttons and adds them to a 
group (an instance of a ButtonGroup) and a container (an instance of a JPanel): 

ButtonGroup I anguageGroup = new ButtonGroup) ); 

JPanel radioPanel = new J Panel (. . . ); 

for ( i nt i = 0; i < radI oBu11on . Iength; i ++) { 
r a dI oButton [i] = new j Radi oButt on( ...); 

I anguageGroup,a d d(r a di oButton[l]); 
radl oPanel. addfradi oButton[i ]); 

} 

(Three dots . . . represent a piece of actual code not directly relevant here.) 

Here’s the Ch14JRadioButtonSample class: 


Chapter 14 Sample Program: Illustrates the use of J Radi oButton 
FiI e: Ch14J Radi oButtonSarnpl e.j a v a 

*/ 

import javax. swing,*; 
i mpo r t j a va. a wt. *; 
import java,a wt.event.*; 

class Chl4J Radi oButtonSarnpl e extends JFrame 

implements Acti onLi stener, 

I temLi stener { 


pr i 

v at e 

s t a t i c 

final 

i nt 

FRAME 

Wl DTH =3 00 

pri 

vat e 

static 

final 

i nt 

frame" 

HEI GHT = 200 

pri 

vat e 

static 

final 

i nt 

frame’ 

X 0RIGl N = 150 

pri 

vat e 

static 

final 

i nt 

frame’ 

Y’ORI Gl N = 250 
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private J Radi oButton[] radi oButton; 

public static void mai n(Stri ng[] args) { 

Chl4J Radi oButtonSampi e frame = new Chl4J Radi oButtonSampi e() ; 
frame.setVi si bl e(true); 


public Chl4J Radi oButtonSampi e() { 

Container contentPane; 

JPanel radioPanel, okPanel; 

ButtonGroup languageGroup; 

J Button okButton; 

String!] btnText = {“Java", “C++", "Smalltalk", "Ada"}; 

II set the fra me properties 

setSIze ( F R A ME _ Wl DTH, F RAME_ HE I GHT ) ; 

setTitle ("Program Chl4J Radi oButton"); 
setLocati on(FRAME_X_ORI Gl N, F RA ME _ Y_ ORI Gl N) ; 

contentPane = getContent Panel ); 
content Pane, set Backgroundf Col or. WHI TE); 
content Pane, set Layout ( new BorderLayout(J); 

II create and place four radio buttons 

radioPanel = new J Panel (new GridLayout(0,l)); 

radi oPanel . setBorder( BorderFactory. createTi tl edBorder( 

"Pick your favorite' 1 )) 


languageGroup = new ButtonGroup)); 

radioButton = new j Radi oButt on[ btnText.I engt h] ; 

for ( i nt i = 0; i < radi oButton. I ength; i ++) { 

radi oBu11on[ i ] = new J Radi oButton(btnText[i ]); 
radi oButton[i ]. addl temLi stener (thi s) ; 

I anguageGroup,a d d(r a di oButton! i ]); 
radi oPanel. add ( radi oButtonfi ]); 

} 

radi oButton [ 0 ]. setSeI ected ( tr ue) ; //selects the first choice 

II create and place the OK button 

okPanel = new JPanel (new FlowLayoutU); 
okButton = new JButton("OK"); 
okButton. addActi onLi stener (thi s) ; 
okPanel. add(okButton); 

contentPane. add(radi oPanel, Border Layout. CENTER); 
content Pane. add(okPanel , BorderLayout.SOUTH); 

//register 'Exit upon closing' as a default close operation 

setDefaul tCI oseOperati on( EXI T_ON_CLOSE) ; 
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public void acti onPerformed(Acti onEvent event) { 
String favorite = null; 
i nt i = 0; 

while (favorite == null) { 

if ( r adi o Bu11 on [i].i s Se I ec t ed ( ) ) { 

favorite = radi oButton [i], getText () ; 

} 


i ++; 

} 


} 


J Opti onPane. showMessageDi al og(thi s, "Your favorite language is 

+ favorite); 


public void i temStateChanged( I temEvent event) { 

J Radi oButton source = (J Radi oButton) event. getSource ( ); 
String state; 

if (event, get St at eChange( ) == I temEvent. SELECTED) { 
state = "is selected"; 

} else { 

state = "is deselected"; 

} 


} 


J Opti onPane. showMessageDi al og(thi s, "J Radi oButton 111 + 

source, get Text () + 
. + s t a t e ) ; 


Every time a radio button is selected, the itemStateChanged method is called 
twice. The first time is for the deselection of the currently selected item, and the sec¬ 
ond is for the selection of the new item. Also notice the statement 

radi o B u11 o n [ 0 ] .setSel ected(true); 

in the constructor. If we don’t include this statement, then no item will be selected 
when the frame is first opened. For radio buttons, it is more common to start with 
one preselected when they first appear on the screen. 

JComboBox 

The JComboBox class presents a combo box. This class is similar to the JRadioButton 
class in that it also allows the user to select one item from a list of possible choices. The 
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Program Chl4JComboBoxSample 


Pick your favorite 


OK 


Program Chl4JComboBoxSample 


^JnJxJ 


Pick your favorite 



OK 


The state when the frame first appeared The state after the items in the combo box 

on the screen. are revealed by clicking on the down arrow. 


Figure 14.24 A frame with one combo box (drop-down list) and one pushbutton. 


difference between the two lies in how the choices are presented to the user. Another 
name for a combo box is a drop-down list, which is more descriptive of its interaction 
style. Figure 14.24 shows a frame with one combo box and one pushbutton. 

We can construct a new JComboBox by passing an array of String objects, for 
example, 

String!] comboBoxItem 

= {"Java", "C ++", "Smalltalk", "Ada"}; 

JComboBox comboBox = new JComboBox(comboBoxltem); 

A JComboBox object generates both action events and item events. An action 
event is generated every time a JComboBox is clicked (note it is not that common to 
process action events of JComboBox). Every time an item different from the cur¬ 
rently selected item is selected, an item event is generated and the itemState- 
Changed method is called twice. The first time is for the deselection of the currently 
selected item, and the second is for the selection of the new item. Notice that when 
the same item is selected again, no item event is generated. 

To find out the currently selected item, we call the getSelectedltem method of 
JComboBox. Because the return type of this method is Object, we must typecast to 
the correct type. For this example, items are String objects, so we write 

String selection = (String) comboBox, getSelectedltem)); 

Also, we can call the getSelectedlndex method to retrieve the position of the se¬ 
lected item. The first item in the list is at position 0. 

Here’s the Ch14JComboBoxSample class: 


/ * * 

Chapter 14 Sample Program: Illustrates the use of JComboBox 
File: Chl4J ComboBoxSampI e. j ava 

*1 
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import javax.swing.*; 
i mpo r t j a v a. a wt. *; 
import java.a wt.event.*; 

class Chl4J ComboBoxSampI e extends J F r a me 

implements Acti onLi stener, 

I temLi stener { 

private static final i nt FRAME_WI DTH = 3 0 0; 

private static final i nt FRAME_HEI GHT = 200; 

private static final i nt FRAME_X_ORI Gl N = 150; 

private static final i nt FRAME_Y_ORI Gl N = 2 5 0; 

private JComboBox comboBox; 

public static void mai n(Stri ng[] args) { 

Chl4J ComboBoxSampI e frame = new Chl4J ComboBoxSampI e( ) ; 
fra me, setVi si bl e(true); 


public Chl4J ComboBoxSampI e() { 

Cont ai ner cont ent Pane; 
jPanel comboPanel, okPanel; 

J Button okButt on; 

String!] c o mb o Box I t e m = {"java", " C++" , " S ma I I t a I k" , "Ada" } ; 

II set the fra me properties 

setSize ( F RAME_ Wl DTH, F RA ME _ HE I GHT) ; 
setTitle ("Program Chl4J ComboBoxSampI e") ; 
setLocati on( FRAME_X_ORI Gl N, FRAME_Y_ORI Gl N) ; 

contentPane = getContentPane ( ); 
contentPane. set Background! Col or. WHITE); 
contentPane, setLayoutfnew Border Layout ()); 

II create and place a combo box 

comboPanel = new ) Panel ( new FI owLayout ()); 
comboPanel ,setBorder(BorderFactory.createTitl edBorder( 

"Pick your favorite")); 

comboBox = new JComboBox(comboBoxltem); 
comboBox. a d d I temLi stener (thi s) ; 
comboPanel .add(comboBox); 

II create and place the OK button 

okPanel = new JPanel (new FlowLayout(l); 
okButt on = new j Button! “OK"); 
okButt on. addActi onLi stener (thi s) ; 
okPanel. add(okButton); 

contentPane, add( comboPanel , Border Layout.CENTER); 
contentPane. add( okPanel, Bor der Layout. SOUTH); 
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//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 

} 

public void acti onPerformed(Acti onEvent event) { 

String favorite; 
i nt I oc; 


favorite = (String) comboBox. getSel ectedl tem( ) ; 
loc = comboBox. getSel ectedl ndex(); 


} 


J Opt i onPane. showMessageDi al og(this, "Currently selected item '" + 

favorite + "' is at index position " + loc); 


public void i temStateChanged(l temEvent event) { 

String state; 

if ( event, get St at eChange( ) == I temEvent. SELECTED) { 
state = "is selected " ; 

} else { 

state = "is deselected "; 

} 


} 


J Opti onPane. showMessageDi al og(thi s, "JComboBox Item '" + 

event, getltemf) + 
. + s t a t e ) ; 


JList 

The JList class is useful when we need to display a list of items, for example, a list 
of students, a list of hies, and so forth. Figure 14.25 shows a frame with one JList 
listing animals with three-letter names and one pushbutton. 

We can construct a JList object in a manner identical to the way we construct 
a JComboBox object, that is, by passing an array of String, such as 

S t ri n g [] n a me s = {"Ape", "Bat", "Bee", “Cat", 

"Dog", "Eel", "Fox", “Gnu", 

"Hen", "Man", "Sow", "Yak"}; 

JList list = new JList (names); 

With JList, we have an option of specifying one of the three selection modes: 
single-selection, single-interval, and multiple-interval. The single-selection mode 
allows the user to select only one item at a time. The single-interval mode allows the 
user to select a single contiguous interval. And the multiple-interval mode allows 
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The state when the frame first appeared 
on the screen. 



The state after the item Gnu is selected. 


Figure 14.25 A frame with one list and one pushbutton. 


the user to select multiple contiguous intervals (each interval will include one or 
more items). The multiple-interval mode is the default mode. The following three 
statements show how to set the three selection modes: 

I i st. setSel ecti on Model 

Li stSel ecti on Mo del . SI NGLE_SELECTI ON); 

list. setSelection Model 

Li stSel ecti on Mo del . SI N G L E _ I NTERVALSELECTI ON) ; 

list.setSelectionMo de( 

Li stSel ecti onModel. MULTI PLE_I NTERVAL_SELECTI ON); 

Because multiple items can be selected, we use getSelectedValues and 
getSelectedlndices to retrieve an array of selected items and an array of the indices 
of the selected items, respectively. The following code will display the selected 
items and their index positions: 

Obj ect [ ] name; 

i nt [ ] I oc; 

name = Ii st. getSel ectedVal ues(); 

loc = list. getSelectedlndices!); 

for ( i nt i = 0; i < name,length; i ++) { 

System, out, pri ntl n((Stri n g ) n a me [ i ] + 


The return type of getSelectedValues is an array of Object, so we typecast each item 
in the name array to String before printing it on System.out. If we know the selec¬ 
tion mode is single selection, then we can use getSelectedValue and get- 
Selectedlndex instead. Notice in the code that we are not adding a JList object di¬ 
rectly to a panel. Instead, we wrap it in a JScrollPane and add this JScrollPane to a 
panel because JList itself does not include scroll bars. 
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Here’s the Ch14JListSample class: 



Chapter 14 S a mp I e Program: Illustrates the use of JList 


File: Chl4J Li stSampI e. j ava 

*1 


import j avax. swi ng. *; 
i mpo r t j ava. a wt. *; 
import java.a wt.event.*; 


class Chl4J Li stSampI e 


extends J Fra me 
i mpI e me n t s 


Acti onLi stener { 


private static final i nt FRAME_WIDTH = 300 

private static final i nt FRAME_HEI GHT = 250 

private static final i nt FRAME_X_ORI Gl N = 150 

private static final i nt FRAME_Y_ORI Gl N = 250 


private JList list 


public static void mai n(Stri ng[] args) { 

Chl4J Li stSampI e frame = new Chl4J Li stSampI e( ) ; 
fra me, setVi si bl e(true); 

} 


public Chl4J Li stSampI e() { 

Cont ai ner cont ent Pane; 

JPanel listPanel, okPanel; 

JButton okButt on; 

“Cat", 
"Gnu", 
"Yak" }; 


St r i ng 11 n a me s = {"Ape", "Bat", "Bee", 
"Dog", "Eel", "Fox", 
" Hen" , " Man" , " Sow", 


II set the fra me properties 

setSize ( F R A M E _ Wl DT H, F RA ME _ HE I GHT) ; 
setTitle ("Program Chl4J Li stSampI e2"); 
setLocati on( FRAME_X_ORI Gl N, FRAME_Y_ORIGl N); 


contentPane = getContentPane ( ); 
contentPane, setBackground(Col or, WHITE); 
contentPane, set Layout ( new Border Layout ()) ; 


II create and place a JList 

listPanel = new J Panel (new GridLayout(0,l)); 

I i stPanel . setBorder(BorderFactory. createTi tl ed Bo r der( 

"Three - I etter A n i ma I N a me s" ) ); 

list = new J Li st(names); 

listPanel. a d d ( new JScrollPane(list)); 
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list.setSelection Model 

Li stSelectionModel.MULTI PLEI NTERVALSELECTI ON); 

II this is default, so the explicit call is not necessary 

II create and place the OK button 

okPanel = new J Panel (new FlowLayoutU); 
okButton = new (Button! "OK"); 
okButton. addActl onLi stener(this); 
okPanel. add( okBut t on) ; 

content Pane. add( I istPanel , Border Layout. CENTER) ; 
content Pane. add(okPanel, Border Layout. SOUTH) ; 

//register 'Exit upon closing' as a default close operation 

setDefaul tCI oseOperati on( EXI T_ON_CLOSE) ; 

} 

public void acti onPerformed(Acti onEvent event) { 

0 b j e c t [ ] n a me; 
i nt [] I oc; 

name = I i st. getSel ectedVal ues( ) ; 

I oc = I i st. get Sel ect edl ndi ces( ); 

System, out. p r i n 11 n ( " Currently selected animal names are"); 
for ( i nt i = 0; i < name.length; i ++) { 

System, out. pri ntl n((Stri ng)name[i ] + " at position " + I o c [ i ] ) ; 

} 

} 

} 


JSlider 

The JSlider class represents a slider in which the user can move a nob to a desired 
position. The position of the nob on a slider determines the selected value. Fig¬ 
ure 14.26 shows a frame with three sliders. This is a classic example of sliders 
where the user moves the three nobs to set the red, green, blue (RGB) value in 
selecting a color. Values for the R, G, and B range from 0 to 255, inclusive. Some 
of properties we can set for a JSlider object are the minimum and maximum range 
of values, whether to display the tick marks, the spacing of major and minor tick 
marks, whether to display the label for the major tick marks, and the placement 
orientation (either vertical or horizontal). 

The sliders in the sample program are created and initialized in the following 
manner: 


JSlider slider = newJSliderl); 

slider.setOrientati on(J SIi der.VERTICAL); 

slider.setPai ntLabel s(true); II show tick mark labels 

sii der.setPai ntTi cks(true) ; II show tick marks 
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Program ChlTJListSample 


RGB Color Selection 



c 

> 250 0 

> 250 C 


250 



200 

200 


200 



150 

150 


150 



100 

100 


100 



50 

50 


50 



0 

0 


0 



The state when the frame first 
appeared on the screen. 



The state after three nobs are 
moved. 


Figure 14.26 A frame with three vertical sliders for setting an RGB value. 


der. 

set 

Mi 

ni mum( Ml N COLOR); 

der. 

set 

Ma: 

xi mu m( MAX’COLOR); 

der. 

set 

Va 

ue( MA X _ COL OR); / 

der. 

set 

Ma] 

j orTi ckSpacing(50 

der. 

set 

Mi 

norTi ckSpaci ng(25 


When a nob is moved, a JSlider object generates a change event (this event occurs 
when there’s a change in the event source, such as the nob is moved). To process 
change events, we must register change event listeners to a JSlider event source 
object. The class that implements the ChangeListener interface must define a 
method called stateChanged, whose parameter is an instance of ChangeEvent. For 
this program, whenever a change event is generated, we read the value from each 
slider and set the background of a panel to a designated color. Here’s the body of 
the stateChanged method: 

i nt R, G, B; 

R = redSI ider.getValue(); 

G = greenSIider.getVal ue( ); 

B = bl ueSIi der. getVal ue(); 

col orPanel . setBackground( new Color (R, G, B )) ; 
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Here’s the Ch14JSIiderSample class: 


Chapter 14 Sample Program: Illustrates the use of JSlider 
File: Chl4J SI i derSampI e. j ava 


import javax.swing,event.*; 
import javax.swing,*; 
i mpor t j a va, a wt. *; 


class Chl4J SI i derSampI e extends J F r a me 

implements ChangeLi stener { 


pr i vat e 

st at 

i c 

final i 

nt 

FRAME Wl DTH 

450 

pr i vat e 

s t a t 

i c 

final i 

nt 

frame’height 

250 

pr i vat e 

st at 

i c 

final i 

nt 

FRAME’X ORIGl N = 

150 

pr i vat e 

s t a t 

i c 

final i 

nt 

FRAME~Y~ORIGl N = 

250 

pr i vat e 

s t a t 

i c 

final i 

nt 

Ml N COLOR = 0; 


pr i vat e 

st at 

i c 

final i 

nt 

MA X ~ COLOR = 2 5 5; 


pr i vat e 

J SI I 

d e r 

r edSIi 

der 

; 


pr i vat e 

j SI I 

d e r 

greenSIi der; 


pr i vat e 

j si i 

d e r 

bl ueSIi der; 


pr i vat e 

j Panel 

col o r P a n e1 

' 


public 

st at i 

c void ma i 

n( St ri ng[ ] ar gs ) { 



Chl4J SI i derSampI e fra me = new Chl4J SI i derSampI e() ; 
frame.setVisibie(true); 

} 


public Chl4J SI i derSampI e( ) { 
Container contentPane; 
jPanel sliderPanel; 


II set the fra me properties 

setSIze ( F R A ME _ Wl DTH, F RAME_ HE I GHT ) ; 
setTitle (“Program Chl4J Li stSampI e" ) ; 
set Locat i on( F RAME_ X_ ORI Gl N, F RAME_Y_ ORI Gl N) ; 


contentPane = getContent Panel ); 
contentPane,set Backgr ound( Col or. WHI TE); 
content Pane.set Layout ( new BorderLayout(l); 


II create and place a jList 

sliderPanel = new J Panel ( new FlowLayout(l); 
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si i derPanel . setBorder(BorderFactory. createTi tl edBorder ( 

"RGB Color Selection")); 


redSlider = createSI ider(MAX_C0L0R); 
greenSlider = createSI i der ( MAX_C0L0R); 
blueSlider = createSI i der( MA X_ C 0 L 0 R ) ; 

si i derPanel. addfredSIi der); 
si i derPanel. addlgreenSli der); 
siiderPanel. add(bl ueSIi der); 

colorPanel = new J Panel ( ); 

col orPanel . setBackground(Col or.whi te); 

colorPanel. setBorder(BorderFactory.createLowe redBevel Border))); 
contentPane. add(col orPanel , Border Layout. CENTER) ; 
contentPane. a d d ( si i derPanel , Bor der Layout. WE ST); 

//register 'Exit upon closing' as a default close operation 

set Def aul tCI oseOperati o n ( E XI T_ON_CLOSE); 


public void stateChanged ( ChangeEvent event) { 
i nt R, G, B; 

R = redSlider. g e t V a I u e () ; 

G = greenSlider. get VaI ue () ; 

B = bl ueSIider.getVal ue( ); 

col orPanel .setBackground(new Col or ( R, G, B )) ; 

} 

private JSlider c r ea t e SI i d e r ( i nt value) { 

JSlider slider = new JSliderf); 

si i der. setOri entati on(J SI i der. VERTICAL); 

slider.setPai ntLabel s(true); 

si i der.set Pai ntTi cks(true); 

si i der. set Mi ni mum(MI N _ C 0 L 0 R ) ; 

si i der. set Maxi mum(MAX_COLOR); 

sii der.setVal ue(val ue) ; 

slider.set Maj orTickSpaci ng(50); 

si i der.setMi norTickSpaci ng(25); 

si i der.addChangeLi stener(this); 

return slider; 

} 

} 
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14.8 Menus 

Practical programs with a graphical user interface will almost always support 
menus. In this section we will describe how to display menus and process menu 
events by using JMenu, JMenultem, and JMenuBar from the javax.swing package. 
Let’s write a sample code to illustrate the display of menus and the processing of 
menu item selections. We will create two menus, File and Edit, with the following 
menu items: 


File 


Edit 


New 


Cut 


Open... 


Copy 

Save 


Paste 

Save As... 



Quit 




If the menu item Quit is selected, then we terminate the program. When a menu item 
other than Quit is selected, we print a message that identifies the selected menu 
item, for example, 

Menu item 'New' is selected 

Figure 14.27 shows a Ch14JMenuFrame when it is first opened and after the menu 
choice Save is selected. 

One possible sequence of steps to create and add menus is this: 

L Create a JMenuBar object and attach it to a frame. 

Z Create a JMenu object. 

3. Create JMenultem objects and add them to the JMenu object. 

4 Attach the JMenu object to the JMenuBar object. 



When the frame first 
appears on the screen. 



After the menu item 
Save is selected. 


Figure 14.27 Ch14JMenuFrame window when it is first opened and after the menu item Save is selected. 
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We will create two JMenu objects: fileMenu and editMenu. We create a file- 
Menu object as 

f i I e Me n u = new JMenu("File"); 

The argument to the JMenu constructor is the name of the menu. After the menu is 
created, we add a menu item to it. A menu item is the event source of menu selection, 
so we need to register an action listener to every menu item we add to the menu. In 
this sample code, we will let a Ch14JMenuFrame object be the action listener of all 
menu items. To create and add a menu item New to fileMenu, we execute 

item = new J M e n u I t e m( "New") ; II New 
item. addActi onLi stener(thi s); 
fileMenu.add(item); 

We repeat this sequence for all other menu items. Menu items are placed from 
the top in the order they are added to the menu. We can also include a horizontal line 
as a separator between menu items by calling the menu’s addSeparator method. 

fiIeMenu. addSeparator( ); 

After the menus and their menu items are created, we attach them to a menu 
bar. In the constructor, we create a JMenuBar object, attach it to the frame by calling 
the frame’s setMenuBar method, and add these two JMenu objects to the menu bar. 

JMenuBar menuBar = new J Me n u B a r ( ) ; 

set MenuBar( menuBar) ; //attach it to the frame 

menuBar. addffi i eMenu); 
menuBar. addfedi tMenu); 

To display which menu item was selected, we use a JLabel object response. 
We add response to the frame by 

response = new J Label ("Hel I o, this is your menu tester."); 
response. setSi ze(250, 50); 
contentPane. add(response); 

When a menu item is selected, the registered action listener’s actionPerformed 
method is called. The actionPerformed method of the Ch14JMenuFrame is defined as 
follows: If an event source is a menu item, the getActionCommand method of 
ActionEvent returns the menu’s text. We test if the returned text is Quit. If it is, we 
terminate the program. Otherwise, we set the text of response to indicate which 
menu item was selected. Here’s the method body of actionPerformed: 

String menuName; 

menu Name = event, getActi onCommand () ; 

if ( menuName. equal s("Qui t") ) { 

System, exit(0); 
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} else { 

response, s e t T e x t ( "Menu 

} 


item'" + me n u N a me + 
is selected"); 


Here’s the complete Ch14JMenuFrame program: 



Chapter 14 Sample Program: Displays a frame with two menus 


File: Chl4J MenuFrame. j ava 

*/ 


import javax.swing,*; 
i mpor t j a va, a wt. *; 
import java,a wt.event.*; 


class Chl4J MenuFrame 


extends JFrame implements Acti onLi stener { 


pr i vat e 

static fi 

na 1 

i nt 

pr i vat e 

static fi 

na 1 

i nt 

pr i vat e 

static fi 

na 1 

i nt 

pr i vat e 

static fi 

na 1 

i nt 


FRAME Wl DTH =300 
FRAME'HEIGHT = 250 
FRAME’X ORIGl N = 150 
FRAME’y’ORI Gl N = 250 


private j Label 
private j Me n u 
private j Me n u 


response; 
f i I e Me n u; 
edit Menu; 


II . 

II Mai n met hod 


public static void main(String[] args) { 

Chl4J MenuFrame frame = new Chl4JMenuFrame(); 
frame.setVi si bl e(true); 

} 

public Chl4J MenuFrame!) { 

Container contentPane; 

II set the fra me properties 
s et Ti11 e ( "Chl4J MenuFrame" ) ; 
setSize ( FRAME, Wl DTH, F RA ME _ HE I GHT) ; 
s et Res i z a bl e ( f a I s e ) ; 

setLocati on ( FRA ME _X_ORIGl N, FRAME_Y_ORI Gl N) ; 

contentPane = getContent Panel ); 
content Pane.set Layout ( new FlowLayout(l); 

II create two menus and their menu items 

createFiI eMenu () ; 
createEdi t Me n u () ; 
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II and add them to the menu bar 

JMenuBar menuBar = new J MenuBar ( ) ; 
setj MenuBar) menuBar); 
menuBar. add(fi I eMenu) ; 
menuBar. add(edi tMenu); 


II create and position response label 

response = new J Label("Hei I o, this is your menu tester."); 

response. setSi ze(250, 50); 

contentPane.add(response); 

setDefaul tCI oseOperati on( EXI T_0N_CL0SE) ; 

} 

public void acti onPerformed(Acti onEvent event) { 

String menuName; 

menuName = event. getActi onComma n d () ; 


if (menuName. equal s("Qui t' 1 ) ) { 
System, exit(O); 

} else { 

response.setText (" Menu Item 

} 

} 

private void createFiI eMenu( ) { 
j Me n u I t e m item; 

f i I e Me n u = new JMenu("File"); 

item = new j Menul t em( " New” ) ; 
item. addActi onLi stener(thi s); 
fileMenu.add(item); 

item = new J M e n u I t e m( " 0 p e n" ) ; 
i tern. addActi onLi stener(this); 
fi leMenu.add(item); 

item = new J M e n u I t e m( " S a v e" ) ; 
item. addActi onLi stener(thi s); 
fileMenu.add(item); 

item = new J Menul tem("Save As., 
item. addActi onLi stener(this); 
fileMenu.add(item); 

fi I eMenu, addSeparator(); 

item = new j MenuI t e m( " Qui t" ) ; 
item. addActi onLi stener(thi s); 
fileMenu.add(item); 


+ me n u N a me + " 1 is selected."); 


II New 

//Open.. . 

//Save 

" ); //Save As... 

//add a horizontal separator line 
II Qui t 
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} 


private void createEdi tMenu() { 

J Me n u I t e m item; 

edi t Menu = new j Menu ( "Edi t" ) ; 

item = new J M e n u I t e m( " C u t" ) ; //Cut 

item. addActi onLi stener(this); 
editMenu.add(item); 

item = new JMenultem("Copy"); //Copy 
item. addActi onLi stener(thi s); 
editMenu.add(item); 

item = new j Me nultem(" Paste"); //Paste 
i tem. addActi onLi stener(this); 
editMenu.add(item); 



If the size of text for the response label is too small, then we can make it bigger by 
including the following statement in the constructor: 

response.setFontf new F o n t("Helvetica", /* f o n t name*/ 

Font. BOLD, /*f ont style*/ 

16 ) ); /* f o n t size*/ 


W 

Quick 

CHECK 

V 


L To which object do we register as an action listener— JMenu, JMenultem, or 
JMenuBar? 

Z How do we get the text of a selected menu item in the actionPerformed 
method? 

3. How do we place a horizontal bar between two menu items? 


14.9 Handling Mouse Events 

In this section we describe the handling of mouse events. Mouse events include 
such user interactions as moving the mouse, dragging the mouse (i.e., moving 
the mouse while the mouse button is being pressed), and clicking the mouse 
buttons. 
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Let’s look at an example in which we display the x and y pixel coordinates of 
a location where a mouse button is pressed. We will define a subclass of JFrame, 
named Ch14TrackMouseFrame, that handles the left mouse button click events, and 
we will use System.out to print out the location of mouse clicks. Note: For a system 
with a one-button mouse, we treat this button as the left mouse button. 

A Ch14TrackMouseFrame object is an event source of mouse events. We will 
let this object be a mouse event listener also. For a Ch14TrackMouseFrame object to 
be a mouse event listener, its class must implement MouseListener. This inter¬ 
face has five abstract methods: mouseClicked, mouseEntered, mouseExited, mouse- 
Pressed, and mouseReleased. The argument to all five methods is an instance of 
MouseEvent. 

The class declaration for Ch14TrackMouseFrame will look like this: 

class Chl4TrackMouseFrame extends Frame 

implements MouseListener { 

} 

In the constructor we set the frame properties and register this frame as a mouse 
event listener of itself. The constructor is defined as 

public Chl4Tr ackMouseFr ame { 

II set the fra me properties 

//register itself as its mouse event listener 

addMouseLi stener(thi s); 

} 

When the left mouse button is clicked, the mouseClicked method of its mouse 
event listener is called. In this method, we want to find out the x and y coordinates 
of the mouse click point and print out these values in output. To find the x and y co¬ 
ordinate values, we use the getX and getY methods of MouseEvent. So the 
mouseClicked method of Ch14TrackMouseFrame is defined as 

public void mouseClicked! MouseEvent event ) { 

i nt x , y ; 

x = event. get X( ) ; //return the x and y coordinates 

y = event, g e t Y () ; II of a mouse click point 

System, out. pri ntl n("[" + x + " , " + y + " ] " ); 

} 

This method is called every time the left mouse button is clicked, that is, 
the mouse button is pressed down and released. If we want to detect the mouse 
button press and release separately, then we can provide a method body to the 
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mousePressed and mouseReleased methods. For example, if we define these 
methods as 

public void mousePressedf MouseEvent event) { 

System, out, p r i n 11 n ( " Do wn" ); 

} 


and 


public void mouseRel easedf MouseEvent event) { 
System, out. p r i n 11 n ( " U p" ) ; 

} 

instead of empty method bodies, then we will see something like 


Do wn 
Up 

[ 200 , 120 ] 


when we click a mouse button. 

Before we present the complete program, let’s extend the mousedicked 
method so that when the left mouse button is double-clicked, we will terminate the 
program. We check the number of button clicks by calling the getClickCount 
method of MouseEvent. Here’s the method that terminates the program when a 
double-click occurs (a single mouse click will print out the location of a mouse 
click, as before): 

private static final i nt DOUBLECLICK = 2; 

public void moused i ckedfMouseEvent event) { 

if ( event,get Cl ickCount () == DOUBLE_CLI CK) { 

System, exit (0); 

} else { //print out mo use click location 

i nt x, y; 

x = event. get X( ) ; 
y = event. get Y( ) ; 

System, out. pri ntl n("[" + x + " , " + y + " ] " ); 

} 

} 

Because a double-click is a sequence of two single clicks, this method is 
called twice when you double-click. The getClickCount method returns 1 for the 
first call and returns 2 for the second call. 
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Here’s the complete program listing: 


/ * 

Chapter 14 Sample Program: Tracks the mouse movement 
File: Chl4TrackMouseFrame.j ava 

*/ 

import j avax. swi ng. *; 
import java, a wt. event.*; 
import j a v a. i o. *; 

class Chl4Tr ackMouseFr ame extends JFrame implements MouseLi stener { 


Pt 

i vat e 

static 

final 

i nt 

FRAME 

Wl DTH 

= 4 5 0; 

Pt 

i vat e 

static 

final 

i nt 

FRAME 

HEI GHT 

= 3 0 0; 

Pt 

i vat e 

static 

final 

i nt 

FRAME 

X ORI Gl N 

= 150; 

Pt 

i vat e 

static 

final 

i nt 

FRAME 

Y ORI Gl N 

= 2 5 0; 

Pt 

i vat e 

static 

final 

i nt 

DOUBLE 

CL 1 CK 

= 2; 


Ma i n 

met hod 







II 

public static void mai n(Stri ng[] args) { 

Chl4Tr ackMouseFr ame frame = new Chl4TrackMouseFrame(); 
fra me. setVi si bl e(true); 

} 

public Chl4TrackMouseFrame() { 

II set f r a me properties 
s et Ti 11 e (“ Tr a c k Mo u s e F r a me" ); 

setSize ( F R A ME _ Wl DTH, F R A ME _ HE I GHT ) ; 

setResi zabl e ( f a I se); 

setLocation ( F RAME_X_ORI Gl N, F RAME_Y_ ORI Gl N) ; 
set Def aul tCI oseOperati o n ( E X I T_ON_CLOSE); 

//register self as a mouse event listener 

addMouseLi stenerfthi s) ; 

} 

public void moused i ckedfMouseEvent event) { 

if ( e v e nt, getCli ckCount () == DOUBLE_CL I CK) { 

System. exit(O); 

} else { 

i nt x , y ; 
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x = event, g e t X () ; 

1 /get the x 

and y 

coor di nates 


y = event, g e t Y () ; i 

'/the mo u s e 

click 

po i 

nt 

} 

publ 

System, out. printlnl 

} 

["[" + x + 11 

1 , " + I 

i + 

" 1" ); 

ic void mouseEntered 1 

[MouseEvent 

event ) 

{ 

} 

publ 

ic void mouseExi ted 1 

[MouseEvent 

event ) 

{ 

} 

publ 

ic void mousePressed I 

[MouseEvent 

event ) 

{ 


} 

System, out. pr i nt 1 n ( " Down" ); 




publ 

ic void mouseRel easedl 

[MouseEvent 

event ) 

{ 



System, out. p r i n 11 n ( " U p “ ) ; 





} 


SketchPad 

Let’s try another example. The basic idea of this program is to keep track of three 
events: 

L The left mouse button is pressed down. 

Z The right mouse button is pressed down. 

3. The mouse is dragged. 

Notice that we are processing mouse button presses, not clicks. {Note: For 
the Mac platform, a mouse button press is treated as the left button press, and the 
Command press is treated as the right button press. For a platform that supports 
three mouse buttons, the middle mouse button is also treated as the left mouse 
button.) 

To implement this class, we will declare Ch14SketchPad to implement two in¬ 
terfaces: MouseListener and MouseMotionListener. Since we want a Ch14SketchPad 
frame to process mouse button clicks, we must implement the MouseListener inter¬ 
face. In addition, we need to implement the MouseMotionListener interface to track 
the mouse dragging. The MouseMotionListener interface includes two abstract 
methods: mouseDragged and mouseMoved. The argument to both methods is an in¬ 
stance of MouseEvent. 

When a mouse button, either the left or right button, is pressed, the event lis¬ 
tener’s mousePressed is called. Let’s study how we should implement this method. 
If the right mouse button is pressed, then we have to erase the current drawing. If 
the left mouse button is pressed, then it is the start of a new mouse drag, so we have 
to remember the location where the left button is pressed. To determine which 
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mouse button is pressed inside the mousePressed method, we call the isMetaDown 
method of MouseEvent as 

if (event. i sMetaDown()) { 

II the right button is pressed 

} 

The isMetaDown method returns true if the right button is pressed. We don’t have a 
method such as isRightButtonPress in MouseEvent because not all platforms support 
the right mouse button. The Mac platform, for example, has only one mouse button, 
and for the Mac, the Command press is treated as the right mouse button press. 

The code to erase the contents of the window is 

if (event. i sMetaDown()) { 

II the right button is pressed 
II so erase the contents 
Graphics g = getGraphi cs( ); 

Rectangle r = get Bounds! ) ; 

g. c I ea r Rec t ( 0, 0, r.width, r. height); 

g. dispose)); 

} 

We erase the contents by drawing a filled rectangle as big as the window itself with 
the rectangle filled in the background color. The getBounds method returns the size 
of a window. 

If it is not a right mouse button press, then it is a left button press, so we re¬ 
member the first position to draw a line. 

if ( eve nt. i s Met a Down ( )) { 

II the right button is pressed 

} else { 

//re me mb e r the starting point of a new mouse drag 
I a s t _ x = x; 

I a s t _ y = y; 

} 

e position ( x, y) is computed at the beginning of the mousePressed method as 

int x = event,get X( ) ; 
int y = event,get Y( ) ; 

The getX and getY methods of the MouseEvent class return the .r and y coordinates, 
respectively, of the point where the mouse button is pressed. 

Now, to process the mouse drag event, we need to define the mouseDragged 
method. From the argument object MouseEvent, we get a new position (x, y) and 
draw a line from the previous position to this new position, using the Graphics object 
g as follows: 

g.drawLi ne(I ast_x, I a s t _ y, x, y); 


last_x and last_y 

are instance 
variables. 


Th( 
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After the drawing is done, we reset the variables. 

I a s t _ x = x; 

I a s t _ y = y; 

Similar to the mousePressed method, the mouseDragged method is called 
whether the mouse was dragged with the left or right button. So we need to include 
the if test 

if ( !event.i sMetaDown( )) { 

II it's a left mouse button drag, 

II so draw a line 

} 

inside the method so the drawing will occur only for the left mouse button drag. 
Here’s a complete listing of the program: 


Chapter 14 Sample Program: My SketchPad 
File: Chl4SketchPad,java 


import javax.swing,*; 
i mpor t j a va, a wt. *; 
import java,a wt.event.*; 

class Chl4SketchPad extends j Fra me 

i mp I e me n t s 


privat e 

st at i c 

final 

i nt 

FRAME 

private 

static 

final 

i nt 

FRAME 

private 

static 

final 

i nt 

FRAME 

private 

static 

final 

i nt 

FRAME 

privat e 

i nt 1 a s t _ x; 



privat e 

i nt 1 a s t _ y; 




Mo us e L i s t e ne r, Mo u s e Mo t i o n L i s t e n e r { 


Wl DTH 

= 4 5 0; 

HE 1GHT 

= 3 0 0; 

X OR 1 Gl N 

= 150; 

Y’ORI Gl N 

= 2 5 0; 


II . 

II Mai n met hod 


public static void mai n(Stri ng[] args) { 

Chl4SketchPad fra me = new Chl4SketchPad(); 
frame.setVi si bl e(true); 

} 

public Chl4SketchPad() { 

II set f r a me properties 

setTitle ("Chapter 14 SketchPad"); 
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setSize ( F R A ME _ Wl DTH, F RA ME _ HE I GHT) ; 
s et Res i z a bl e ( f a I s e ) ; 

setLocation ( FRA ME _X_ORIGl N, FRAME_Y_ORI Gl N) ; 
setDefaul tCI oseOperati on( EXI T_ON_CLOSE) ; 

I as t _x = I ast _y = 0; 

addMouseLi stener(thi s); //adds itself as mouse and 

addMouseMoti onLi stener(this); //mouse motion listener 


II . 

II Mouse Event Handling 
II . 


public void mousePressed( MouseEvent event) { 
i nt x = event,get X( ) ; 
i nt y = event,get Y( ) ; 

if (event. i sMetaDownf ) ) { 

II the right mo use button is pressed, so erase the contents 

Graphics g = getGraphi cs( ) ; 

Rectangle r =getBounds(); 

g. c I ea r Rec t ( 0, 0, r.width, r. height); 

g. dispose!); 

} else { 

II the left mo use button is pressed, 

//re me mb er the starting point of a new mo use drag 
I a s t _ x = x; 

I as t _y = y; 

} 

} 


public void moused i eked (MouseEvent 

public void mouseEntered (MouseEvent 

public void mouseExi ted (MouseEvent 

public void mouseRe I eased ( MouseEvent 


event ) { } 
event ) { } 
event ) { } 
event ) { } 


II . 

II Mouse Motion Event Handling 
II . 


public void mouseDragged(MouseEvent event) { 
i nt x = event,get X( ) ; 
i nt y = event,get Y( ) ; 

if (! ev e nt.is Me t a Do wn ()) { 

II don't process the right button drag 
Graphics g = getGraphi cs( ); 

g,drawLi ne(l ast_x, I a s t _ y, x, y); 
g, di s pose ( ) ; 
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I a S t _ X = X ; 

I as t _y = y; 

} 

} 

public void mo use Moved ( MouseEvent event) { } 


W 


Quick 


L Which listener object listens to mouse movements? Which listener object 
listens to mouse button presses and clicks? 


CHECK 

v 


Z What is the purpose of the isMetaDown method? 

3. What is the difference between mouseClicked and mousePressed? 


Summary 


The type of user interface covered in this chapter is called a graphical user 
interface (GUI). 

GUI objects in the javax.swing package are collectively called Swing classes. 

To program the customized user interface effectively, we must learn a new 
style of programming control called event-driven programming 

The GUI and related classes and interfaces introduced in this chapter are 


ActionEvent 

JButton 

ActionListener 

JCheckBox 

BorderFactory 

JComboBox 

BorderLayout 

JFrame 

ButtonGroup 

JLabel 

ChangeEvent 

JList 

ChangeListener 

JMenu 

Container 

JMenuBar 

FlowLayout 

JMenultem 

GridLayout 

JOptionPane 

Imagelcon 

JPanel 

ItemEvent 

JRadioButton 

ItemListener 

JScrollPane 

JTextArea 

JSlider 

JTextField 

MouseListener 

MouseEvent 

MouseMotion Listener 
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• The JOptionPane class is used for a simple GUI input and output. 

• GUI objects such as buttons and text fields are placed on the content pane of 
a frame window. 

• The layout manager determines the placement of the GUI objects. 

• The FlowLayout manager places components in left-to-right, top-to-bottom 
order. 

• The BorderLayout manager places components in one of the five regions: 
north, south, east, west, and center. 

• The GridLayout manager places components in one of the equal-size N X M 
grids. 

• GUI objects can be placed on the content pane without using any layout 
manager. Such placement is called absolute positioning. 

• Effective layout of GUI components is achieved by nesting panels and 
applying different layout managers to the panels. 

• JPanel is a container for GUI components. JPanel itself is a GUI component, 
and therefore, we can nest JPanel objects. 

• Event handling is divided into event sources and event listeners. Event 
sources generate events, and event listeners include a method that gets 
executed in response to the generated events. 

• The most common event type is called an action event. 

• Action Listener handles the action events. 

• We use an instance of JButton to represent a pushbutton on a frame. JButton 
objects generate action events. 

• GUI objects dealing with text are JLabel, JTextfield, and JTextArea. The 
JTextField objects generate action events. 

• A JLabel object can include an image of type Imagelcon. 

• The JCheckBox class is used for check-box buttons. An instance of the class 
generates action and item events. 

• ItemEvent is generated when the state (selected/deselected) of an item 
changes. 

• ItemEvent is handled by an instance of a class that implements the 
ItemListener interface. 

• The JRadioButton class is used for radio buttons. An instance of the class 
generates action and item events. 

• The JComboBox class is used for combo boxes, also known as drop-down 
lists. An instance of the class generates action and item events. 

• The JList class is used for displaying a list of items. (Note: A JList object 
generates action and list events. To keep the examples brief and at the 
introductory level, we did not give any sample code that deals with events 
generated by a JList object.) 
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The JSlider class is used for sliders. An instance of the class generates 
change events. 

ChangeEvent is handled by an instance of a class that implements the 
ChangeListener interface. 

We can find out the class to which an object belongs by using the instanceof 
operator. 

A frame has one JMenuBar object. A single JMenuBar can have many 
JMenu objects with many JMenultem objects associated to a single JMenu 
object. 

JMenultem objects generate action events. 

User actions such as moving or dragging the mouse and clicking the mouse 
buttons will result in the generation of mouse events. 

MouseListener handles the button actions, and MouseMotionListener handles 
the mouse movements. 


Key Concepts 


graphical user interface 
Swing classes 
content pane 
absolute positioning 
events 

event-driven programming 

event sources 

event listeners 

instanceof operator 

buttons 

menus 

mouse events 


mouse listeners 
item events 
item listeners 
change events 
change listeners 
layout managers 
nested panels 

radio and check-box buttons 
combo boxes (drop-down lists) 
lists 
sliders 


Level 1 Programming Exercises ★ 

L Write a program that inputs three integers and outputs their sum. Use the 
JOptionPane class for both input and output routines. 

Z Define a subclass of JFrame and name it Ch14MuFrame. Set the subclass so 
its instances will be 400 pixels wide and 450 pixels high and will have a 
blue background. The program terminates when the Close box is clicked. 
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3. Define a JFrame subclass with one pushbutton. When a button is clicked, 
display the message You clicked! using JOptionPane. Closing the frame 
window terminates the program. 

4 Define a JFrame subclass with one pushbutton and one text field. When a 
button is clicked, change the title of the frame window to the text in the text 
field. Closing the frame window terminates the progam. 

5. Modify the Ch14SketchPad program so it will terminate when the left but-ton 
of the mouse is double-clicked. You achieve this by defining an appro-priate 
method body for the mousedicked method. 


Level 2 Programming Exercises ★★ 

& Define a JFrame subclass that has one pushbutton. Initially, the background 
color is white (Color.WFIITE) and the button’s text is ON. When the button 
is clicked, the background of the frame changes to yellow (Color.YELLOW) 
and the text of the button changes to OFF. If the button is clicked again, the 
frame returns to the initial state (ON button text and white background 
color). Because the button text switches back and forth between ON and 
OFF, such button is called a toggle switch. Closing the frame window 
terminates the program. 

7. Define a JFrame subclass that has four vertically positioned buttons. The 
labels for the four buttons are Senior, Junior, Sophomore, and Freshman. 
This is one possible layout: 


( Senior ) 

( Junior ) 


(Sophomore ) 

( Freshman J 


When a button is clicked, display a message that identifies which button is 
clicked, using JOptionPane. 

8 . In the Ch14TextFrame1 class, event handling was done with this class. 
Modify the class so the button events are handled by a ButtonFlandler and 
the text events are handled by a TextFlandler. You can use the ButtonFlandler 
class defined in the chapter, but you need to define your own TextHandler 
class. 

9. A slugging percentage of a baseball player is computed by dividing the total 
bases of all hits by the total times at bat (single = 1 base, double = 2 bases, 
triple = 3 bases, and home run = 4 bases). Write an application that 
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computes the slugging percentage. Create a customized frame and use 
JTextField objects to accept five input values: number of singles, number of 
doubles, number of triples, number of home runs, and number of times at 
bat. When the user clicks the Compute button, display the slugging 
percentage, using JLabel. 

10 . Write an application that draws a circle every time the mouse button is 
clicked. The position where the mouse is clicked will become the center of 
the circle. Set the radius of the circle to 100 pixels. 

Level 3 Programming Exercises ★★★ 

1L Using the frame layout shown, write a program that displays N prime 

numbers, where N is a value entered in the text field. A prime number is an 
integer greater than 1 and divisible by only itself and 1. 


The text field to 
enter the number 
of primes to display 


Prime numbers 


12 . Define an OutputBox class as a subclass of JFrame. The OutputBox class 
provides the functionality of System.out (PrintStream) by supporting these 
methods: 

publ i c voi d pr i nt I n( St r i ng I i ne) 
publ i c voi d pr i nt ( St r i ng t ext ) 

The OutputBox class contains one JTextArea object. Do not use absolute 
positioning. Use the default layout and add a JScrollPane that wraps the 
JTextArea object to the content pane. 

13 . Redo Exercise 10 in Chapter 6, but this time use the OutputBox class created 
in Exercise 12 for output. 

14. Write a graphical user interface for the slot machine program in Exercise 32 
in Chapter 6. Use three JLabel objects for displaying bells, grapes, and 
cherries. Add a button that simulates the motion of pulling down the 
handle. 

15 . Add images to the Exercise 14 solution. Create three gif files, one each for 
the bell, grape, and cherry. Use JLabel objects with Imagelcon to display 
these images on the frame. 



JTextArea 

or 

J List 
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16. Write a MyMenuFrame class with these menu choices. 


File 

Quit 


Edit 

Erase 


Color 

Red 

Green 

Blue 

Pink 

Black 


When the user selects Quit, stop the program. When the user selects one of 
the colors, change the background of the frame (i.e., change the background 
color of the frame’s content pane) to the selected color. When the user 
selects Erase, reset the background color to white. 

17. Write a program that draws a selected geometric shape in random color and 
at a random location. The menu choices for the program are 


Shape 

Circle 

Rectangle 

Square 


18. Extend Exercise 10 by adding the following menu to let the user select the 
shape to draw every time the mouse button is clicked. The clicked point will 
be the center of the selected shape. Choose appropriate values for the 
dimensions of the three shapes. 


Shape 

Circle 

Rectangle 

Square 


19. Rewrite the Ch14TicTacToePanel class by using the approach illustrated in 
Figure 14.21. 

20l Modify the Ch14SliderExample program by adding three text fields, one per 
slider. Place these text fields under the sliders. When the slider value is 
changed, display the slider value in the corresponding text field. The user 
can see the precise RGB values from these text fields. Allow the user to 
modify the RGB values by entering the values in the text fields. When the 
value in a text held is changed, adjust the corresponding slider’s position 
accordingly. 


www.it-ebooks.info 























Exercises 875 


Development Exercises 

For Exercises 21 through 34, use the incremental development methodology 
to implement the program. Design a visually appealing GUI with Swing 
components and layout managers. For each exercise, identify the program tasks, 
create a design document with class descriptions, and draw the program diagram. 
Map out the development steps at the start. Present any design alternatives and 
justify your selection. Be sure to perform adequate testing at the end of each 
development step. 

2L Write a TeachArithmeticFrame class that teaches children arithmetic. The 
frame uses a JLabel for a problem and a JTextField for the user answer. When 
the user presses the Enter key (while the JTextField object is active) or clicks 
the OK button, display a message stating whether the user’s answer is 
correct. When the Next button is clicked, display a new problem. The 
numbers are limited to two digits. 


JLabel 

JLabel 


8x7 = 



Correct! 


( 0K ) 


C Next ^ 


JTextField 


Consider using a larger font for the JLabel and JTextField text. You can 
change the color of text by calling the setForeground method, for example. 

questi onLbl . setForeground(Col or. RED); 

Define a helper class that generates problems. 

22. Extend the TeachArithmeticFrame class so that the numbers of correct and 
incorrect answers are kept. Display these two numbers somewhere on the 
frame. Add the third button labeled Reset. When this button is clicked, the 
counters for correct and incorrect answers are reset to zero. 

23. Modify the mortgage table program of Exercise 30 in Chapter 6. Add this 
menu 


File 

Help 

New Table 


About... 

Quit 
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to the program. When the user selects the menu choice New Table, the 
program opens another frame in which the user can enter three input values. 
The input frame should look something like this: 


Loan Amount: 


Interest Rate: 


Loan Period: 


T Cancel 


) 


^ Compute ^ 


If the user clicks on the Compute button and the three input values are 
valid, generate a mortgage table. Use the OutputBox class from Exercise 12 
to display the mortgage table. If the input values are invalid, then print out 
an appropriate error message. Decide on the range of valid values for the 
loan amount, interest rate, and loan period. When the user selects the 
menu choice About . . . , describe the purpose of the program by using 
another frame. You should create only one input frame, but may decide to 
use more than one OutputBox frame so you can see multiple loan tables 
at once. 

24. Redo Exercise 23 with a new user interface. The left side of a frame is 
used to enter the loan amount, interest rate, and loan period. The right 
side of a frame displays the mortgage table for given input values. The 
following layout is merely a suggestion. Feel free to use other GUI 
components as you see fit. For example, consider using JComboBox for 
entering interest rates and loan periods. 


Display mortage table here 


JLabel —► Loan Amount: 


Interest Rate: 


JTextField 


Loan Period: 


(Compute) 


JTextArea 
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2S (Challenge) Write a class that implements a calculator with the layout 
similar to this: 



The user enters a number, using digit buttons only. Some of the issues you 
need to consider include 

• How to determine whether the user is entering a left operand or a right 
operand. 

• How to handle the entering of multiple decimal points. A typical 
calculator accepts the first decimal point and ignores the rest. For 
example, if you press 1 . 4.3 ., the number entered is 1.43. 

• When the display is 0 and the user enters 0, the display will not 
change. However, if the display is nonzero and the user enters 0, the 0 
is appended to the number currently displayed. 

• How to handle the operator precedence. For example, what will be the 
result if the user enters 4 + 3x2? Will it be 14 or 10? It is easier to 
treat all operators as having equal precedence and process them from 
left to right. 

Study any real four-function calculator and try to implement a software 
calculator that simulates the real calculator as faithfully as possible, but feel 
free to make any reasonable changes. 

26 Extend the calculator of Exercise 25 to allow the user to enter a number 
by using the keyboard. The class needs to implement the KeyListener 
interface and define the keyTyped method. You have to find information on 
KeyListener and KeyEvent from a Java API reference manual. 
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27. Latte Gallery in Carmel, California, is a small gallery that specializes in 
selling contemporary fine art, especially lithographs and photographs. All 
items sold in the gallery are signed and numbered. Write an application that 
keeps track of 

• Customers and their art purchases. 

• Artists and their works that have appeared in the gallery. 

• Current inventory. 

Allow the user to add, delete, or modify the customer, artist, and artwork 
information. An inventory will include the purchase price of the artwork and 
the selling price when sold. Give the user an option to list all customers or 
one customer. The user will specify the customer to display by entering the 
customer’s last name and phone number. 

Define at least four data members for each type of information. For 
customers, include the name, phone number, address, and artwork and artist 
preferences. For artists, include the name, speciality, whether alive or deceased, 
and price ranges of artwork. For artwork, include the title, date purchased, date 
sold, and artist. Feel free to add more data members as you see fit. 

Design appropriate GUI for entering and editing customers, artists, and 
artwork. 

28. Improve the Latte Gallery information manager application by adding the 
following capabilities: 

• List all customers who bought artwork by a given artist. 

• List all artists who are still alive (so you can buy their artwork while 
the price is still reasonable). 

• List all artwork in the inventory that did not sell for over 3 months. 
(This requires the use of the Date class from the java.util package.) 

Adjust the GUI accordingly. 

29. Improve the Latte Gallery information manager application by adding a fea¬ 
ture that allows the user to select a customer from the list of all customers by 
clicking on the customer that he or she wants to see. The listing of all cus¬ 
tomers will include their names. When the user clicks on a name, the full infor¬ 
mation of the selected customer will appear on the right side of the frame. 


Customer List: 


List of 

customer names 


(jshow Detail^ 


Detailed information on a selected customer 
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3a Write a program that plays the game of Fermi. The program generates three 
distinct random digits between 0 and 9. These digits are assigned to 
positions 1, 2, and 3. The goal of the game is for the player to guess the 
digits in three positions correctly in the least number of tries. For each guess, 
the player provides three digits for positions 1, 2, and 3. The program replies 
with a hint consisting of Fermi, Pico, or Nano. If the digit guessed for a given 
position is correct, then the reply is Fermi. If the digit guessed for a given 
position is in a different position, the reply is Pico. If the digit guessed for a 
given position does not match any of the three digits, then the reply is Nano. 
Here are sample replies for the three secret digits 6, 5, and 8 at positions 1, 

2, and 3, respectively. 


Guess 

Hint 



Explanation 

1 2 5 

Nano 

Nano 

Pico 

The value 5 matches but at the wrong position. 

8 5 3 

Pico 

Fermi 

Nano 

The value 5 matches at the correct position. 





The value 8 matches but at the wrong position. 

5 8 6 

Pico 

Pico 

Pico 

All match at the wrong positions. 


Notice that if the hints like the above are given, the player can tell which 
number did not match. For example, given the hint for the second guess, we 
can tell that 3 is not one of the secret numbers. To avoid this, provide hints in 
a random order or in alphabetical order (e.g., it will be Fermi Nano Pico 
instead of Pico Fermi Nano for the second reply). Implement the program 
with an attractive and elegant GUI. 

3L Extend the Fermi playing program by allowing the player to 

• Select the number of secret digits. 

• Select alphabets instead of digits. 

• Include duplicate secret digits. 

Adjust the GUI accordingly. 

3Z Write a personal scheduler application. Each entry in the scheduler is an 
appointment, a to-do item, or a memo. Each entry has the date and the time 
it is entered. An entry can be locked, and if it is locked, the user cannot 
modify it. For an appointment entry, include the person and the place of 
meeting. For a to-do entry, include a short description of a task and the due 
date. For a memo, include a text. Implement the program with an attractive 
and elegant GUI. 

33. Write a rental point-tracking system for an up-and-coming Espresso’s 
Dynamo Mopeds in Monterey, California. To compete against Ms. Latte’s 
Mopeds R Us, Espresso’s Dynamo Mopeds decided to install an automated 
point-tracking system. When a customer first rents a moped, his or her 
information is entered into a database. For each rental, a customer receives 
points, and when the total points reach 100, the customer can rent a moped 
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free for 3 hours or redeem a free movie rental coupon from Espresso’s 
Majestic Movies. The points are earned in the following scheme: 


Renter 

Type 

Points 

College student 

50cc Moppi 

15 


150cc Magnum 

20 

Adult 

50cc Moppi 

10 


150cc Magnum 

15 

Senior 

50cc Moppi 

20 


150cc Magnum 

30 


In addition to the basic operations of updating the point information for 
every rental, include an operation to list all customers who earned over 
100 points. Also, support an operation to edit the customer information. 
Implement the program with an attractive and elegant GUI. 

34. Update the rental point-tracking system to support a new rental system and 
point-awarding rules for Espresso’s Dynamo Mopeds. Now the customers 
can rent only on an hourly basis, and the points are awarded accordingly. 
Upon rental, the customer will state the number of hours he or she will rent 
in increments of 1 hour with a maximum of 10 hours. The rental fee is based 
on the following formula: 


Renter 

Type 

Total Rental 
< 5 hours 

Total Rental 
>5 hours 

College student 

50cc Moppi 

150cc Magnum 

$3.50 per hour 
$4.50 per hour 

$2.50 per hour 
$3.50 per hour 

Adult 

50cc Moppi 

150cc Magnum 

$5.00 per hour 
$6.50 per hour 

$4.00 per hour 
$5.00 per hour 

Senior 

50cc Moppi 

150cc Magnum 

$4.00 per hour 
$5.25 per hour 

$3.00 per hour 
$4.00 per hour 
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Objectives 

After you have read and studied this chapter, you 
should be able to 

• Write recursive algorithms for mathematical 
functions and nonnumerical operations. 

• Decide when to use recursion and when not to. 

• Describe the recursive quicksort algorithm and 
explain how its performance is better than that 
of selection and bubble sort algorithms. 
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Introduction 



w 

e introduced recursion in Chapter 6 and showed how to write recursive meth¬ 
ods to implement mathematical functions. We used mathematical functions in 
Chapter 6 because it is easier to see how the recursion works with mathematical 
functions. However, recursive methods are not limited to implementing mathemat¬ 
ical functions, and we will present several nonnumerical recursive algorithms in 
this chapter. We will also discuss some criteria for deciding when to use recursion 
and when not to. All the recursive algorithms we provide in this chapter, other than 
those we use for explanation, are algorithms that should be written recursively. 


recursive 

method 


15.1 Basic Elements of Recursion 

A recursive method is a method that contains a statement (or statements) that makes 
a call to itself. In Chapter 6, we implemented three mathematical functions using 
recursion. In this chapter, we will present recursive algorithms for nonnumerical 
operations. But before we introduce new examples, let's review one of the recursive 
algorithms we presented in Chapter 6. 

Th efactorial of N is the product of the first N positi ve i ntegers, denoted math- 
ematically as 


N! = N * ( N - 1) * ( N - 2) *... *2*1 

We can define the factorial of N recursively as 

' 1 i f N = 1 

factorial (N) = < 

N * factorial (N-l) otherwise 

We mentioned in Chapter 6 that any recursive method will include the fol¬ 
lowing three basic elements: 

1. A test to stop or continue the recursion. 

2. An end case that terminates the recursion. 

3. A recursive call(s) that continues the recursion. 

These three elements are included in the following recursive factorial method. 


publ i c i nt f a c t o r i a I ( i nt N ) 

{ 

if (|\| == 1) -Test to stop or continue. 

return 1; .*- End case: recursion stops. 

} 
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el se { 


} 


} 


return N * factorial (N-l); 



Recursive case: recursion 
continues with a recursive call. 


15.2 Directory Listing 

Let's try some recursive algorithms for nonnumerical applications. A first nonnu- 
merical recursive algorithm will list the filename of all files in a given directory (or 
folder) of a hard disk and its subdirectories. We will usea File objectfrom the java, io 
package to implement the method. Assuming a Windows platform, we create a File 
object by passing the name of a file or a directory, as in 


File file = new Fi I e("C:/J ava/Proj ects" ); 

Notice that we pass the full path name. If a File object represents a directory, 
then the boolean method isDirectory returns true. To get an array of names of files 
and subdirectories in a directory, we use the list method. 


String!] fileList = fi I e. I i st(); 

Let's call the method directoryListing. The argument to the method will be a 
File object that represents a directory. The basic idea can be expressed as follows: 

pubi i c voi d di rectoryLi sti ng(Fi I e dir) { 

//assumption: dir represents a directory 

fileList = an array of names of files and 

subdirectories in the directory dir; 

for ( each element in fileList) { 

if (a n element is a fil e) { 

out put the element's f i I ename; 11 end case: it's 

11 a file. 

} el se { / /recursive case: it's a directory 
call directoryListing with element as 
an ar gu me nt; 

} 

} 

} 

The complete method is as follows: 

publ i c voi d di rectoryLi sti ng(Fi I e dir) { 

//assumption: dir represents a directory 

String!] fileList = dir.list(); //get the contents 
String dirPath = d i r, ge t Abs o I u t e P a t h (); 
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for (int i = 0; i < fi I eLi st. I ength; i ++) { 

File file = new Fi le(di rPath + " / " + fileList[i]); 

Test-► if (file.isFileO) { //it's a file 

End case-► System, out. pri ntl n( file.getNameO ); 

} el se { 

Recursive case-► di rectoryLi sti ng(fi I e); //it's a directory 

} //so make a recursive call 

} 

} 

Notice the argument we pass to create a new File object inside the for loop is 

File file = new Fi I e(di rPath + File.separator 
+ f i I eLi s t [i ] ); 


where dirPath is set as 

String dirPath = di r.getAbsol utePath(); 

and File.separator is a class constant for the system-dependent character used as the 
file separator. 

ThegetAbsolutePath method returns the full path name for the directory, and 
we need to prepend it to the name (fileList[i]) of a file or a subdirectory in this 
di rectory i n order to make the testi ng 

if (file.isFileO) 

work correctly. 

To give you more practice in reading recursive methods, we will remove the 
assumption that the argument File represents a directory and rewrite the method. 
If the argument File object to directoryListing can be either a file or a directory, 
then we need to check this first. If the argument object is a file, then we list its 
filename and stop the recursion. If the argument object is a directory, then we get 
the list of contents in the directory and make recursive calls. Here's the second 
version: 


Test 

End case 


publ i c voi d di rectoryLi sti ng(Fi I e file) { 

//'file 1 may be a directory or a file 

String!] fileList; 

String pathname = file. getAbsol utePathO; 
if (f i I e. I sFI I e()) { 

II it's a file so 

System, out. pri ntl n(fi I e. getName()); //print it out 


} el se { //it's a directory, so make a recursive call 
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Recursive case->* 


} 


} 


f i I e L i s t = f 

for ( i nt i = 

File next F 

di r ect or yL 

} 


I e. I i s t (); 

0; i < f i I eLi st. length; i ++) { 

I e = new Fi I e(pathname+ File, separator 
+ f i I eLi st [I ]); 

sting(nextFile); //recursive call 


15.3 Anagram 

Our second example of a nonnumerical recursive method is to derive all anagrams 
anagram of a given word. A n anagram is a word or phrase formed by reordering the letters of 

another word or phrase. If the word is cat, for example, then its anagrams are 


Word 


CAT 
C T A 
A T C 
ACT 
T C A 
T A C 


•<-Anagrams 


Figure 15.1 illustrates the basic idea of using recursion to list all anagrams of 
a word. 


Find all anagrams of a word QT] [X] [TJ [o] 
!0 0 00 - 


Recursion 








C \ 

Apply recursion to find all the 

H 

A 

L 

0 


Rotate left 

anagrams of these three letters. 

v.____/ 


0:0 0 


Rotate left 


0:0 


Rotate left 




Recursion 




Recursion 


00- — r Recursion 


Figure 15.1 Howto generate all the anagrams of a word by using recursion. 
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Expressing the basic idea, we have something I ike this: 


publ i c voi danagram( String word) { 
int numOf Chars = word. I ength(); 


if (numOf Chars == 1) { 

II End case: there's only one character left, 
II so we can't make a recursive call 

} el se { 

for (int i = 1; i <= numOfChars; i + + ) { 


char firstLetter = word.charAt (0); 


Figure 15.1 

illustrates the -► 

logic of this for 
loop. 


suffix = wo r d , subst r i ng ( 1 , numOfChars); 

a n a g r a m( suffix); //make a recursive call 
II with the remaining 
//letters in the word 


II rotate left 

word = suffix + firstLetter; 

} 

} 

} 


To derive the real method that executes correctly, we must finalize a number 
of things. First, what will we do when the recursion stops? Hitting upon the end case 
means that we have found one anagram, so we will print it out. Now, this is the 
tricky part. When we call the method recursively, we are passing a word that has 
the first letter chopped off. This means the words being passed to successive recur¬ 
sive calls are getting shorter and shorter. But we need to access all letters in a word 
to print it out. We can solve this problem by passing two parameters: the prefix 
and the suffix of a word. In each successive call, the prefix becomes one letter more 
and the suffix becomes one letter less. W hen the suffix becomes one letter only, then 
the recursion stops. Using this idea, we seethe method now looks like this: 


publ i c voi danagram( String prefix, String suffix) { 
int numOfChars = suffix. Iength(); 

if (numOf Chars == 1) { 

II End case: print out one anagram 
System, out. pri ntl n(prefi x + suffix); 

} el se { 

} 

} 


and this method is initially set with an empty prefix and the word being the suffix, 
as in 


anagr am(" " , " HALO" ); 
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Now, by using the two parameters prefix and suffix, the for loop is written as 


for (int i = 1; i <=n u mO f C h a r s; iff) { 

newSuffi x = suffix.substring(l, numOfChars); 
newPrefi x = prefix + suffi x. charAt (0); 

anagr am(newPr ef i x, newSuffix); //recursive case 

//rotate left to create a rearranged suffix 
suffix = newSuffix + suffi x. charAt (0); 


Putting everything together, we have the final anagram method: 


Test 

End case 


Recursive case 


pubi i c voi danagram( String prefix, String suffix) { 
String newPr efi x, newSuf fi x; 
int numOfChars = suffix. Iength(); 

if ( numOf Chars == 1 ) { 

II End case: print out one anagram 
System, out. pri ntl n(prefi x + suffix); 

} el se { 

for (int i = 1; i <= numOfChars; iff) { 

newSuffix = s uf f i x. s u bs t r i n g ( 1, numOfChars); 
newPrefix = prefix + suffi x.charAt ( 0 ); 

anagra m( newPref i x, newSuffix); 

//recursive call 

//rotate left to create a rearranged suffix 
suffix = newSuffix + suffi x.charAt ( 0 ); 

} 

} 

} 


Because the ending condition for recursion is tricky, let's study carefully the 
test to stop the recursion. We set the test to 

if (n u mOf Cha r s == 1 ) ... 

Is there any assumption we must make about the parameters so that this method will 
work correctly? We mentioned earlier that the initial call to the recursive method is 
something like 

a n a g r a m( "" , "HALO"); 

What would happen if we made the call initially like 


String str = i n p u t Bo x. ge t S t r i n g (); 
a n a g r a m( "" , str); 

and the user entered an empty string? This is left as Exercise 2. 
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w 

Quick 

CHECK 


1. Determine the output of these calls without actually running the method. 

a a na gr a m(" " , " DOG" ); 
b. a n a g r a m(" " , "CAFE"); 


15.4 Towers of Hanoi 

T he obj ecti ve of a puzzl e cal I ed the Towers of Hanoi i s decepti vel y simple, butfind- 
ing a solution is another matter. The goal of the puzzle is to move N disks from 
peg 1 to peg 3 by moving one disk at a time and never placing a larger disk on top 
of a smaller disk. See Figure 15.2. 




( _ 

') 


( 

) 


< 

> 


Peg 1 Peg 2 Peg 3 



Figure 15.2 Towers of Hanoi with N = 4 disks. 



Peg 1 Peg 2 Peg 3 




Recursion 


Move N—l disks 
from peg 1 to peg 2 




Peg 1 Peg 2 Peg 3 


M ove one disk 
from peg 1 to peg 3 


To move N disks 
from peg 1 to peg 3 



Peg 1 Peg 2 Peg 3 




Recursion 


Move N—l disks 
from peg 2 to peg 3 


Figure 15.3 Recursive solution to the Towers of Hanoi puzzle. 
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TheTowers of Hanoi puzzle can be solved very nicely by using recursion. The 
A ha! moment to this puzzle occurs when you realize that you can solve the puzzle 
if somehow you can move the top TV - 1 disks to peg 2. After the top TV - 1 disks 
are moved to peg 2 temporarily, you move the largest disk from peg 1 to peg 3 and 
finally move the TV - 1 disks from peg 2 to peg 3. Figure 15.3 illustrates these three 
steps. The first and the third steps are, of course, the same puzzle with one fewer 
disk and the destination peg changed. So you apply the same logic recursively to the 
first and third steps. W hen the number of disks becomes 1, then the recursion stops. 
Applying this recursive thinking, we can write the method as 

publ i c voi d towersOfHanoi (i nt N, //number of disks 

int from, //origin peg 

int to, //destination peg 

i nt spare) / / " mi d d I e " peg 

{ 

if (N == 1) { 

mo ve On e (f r o m, to); 

} el se { 

t o we r s Of Ha no i ( N-1, from, spare, to); 

mo ve On e (f r o m, to); 

t o we r s Of Ha no i ( N-1, spare, to, from); 

} 

} 

The moveOne is the method that actually moves thedisk. Herewewill define 
the method to print out the move, using System.out. 

pr i vat e voi dmoveOne(int from, int to) { 

System, out. pri ntl n(from + " ---> " + to); 

} 

When we run this method with TV = 4, we get the following output: 


l - - - > 2 

1 - - - > 3 

2 - - - > 3 
1 - - - > 2 

3 - - - > 1 
3 - - - > 2 
1 - - - > 2 

1 - - - > 3 

2 - - - > 3 
2 - - - > 1 

3 - - - > 1 
2 - - - > 3 
1 - - - > 2 

1 - - - > 3 

2 - - - > 3 
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The output is very difficult to read. We can improve the output considerably 
by padding a varying number of blank spaces to show the level of recursion. We can 
change the output to 


1 - - - > 2 

1 - - - > 3 

2 - - - > 3 
1 - - - > 2 

3 - - - > 1 
3 - - - > 2 
1 - - - > 2 

1 - - - > 3 

2 - - - > 3 
2 - - - > 1 

3 - - - > 1 
2 - - - > 3 

1 - - - > 2 

1 - - - > 3 

2 - - - > 3 


These steps are for 

■*1 -moving 3 disks from 

peg 1 to peg 2. 


by rewriting the methods as follows: 


publ i c voi d towersOfHanoi (i nt N, //number of disks 

int from, //origin peg 
i nt t o, //desti nati on peg 
i nt s p a r e, / / " mi d d I e" peg 
int indent)//# of leading spaces 

{ 

if (N == 1) { 

moveOne (f r o m, to, indent); 

} el se { 

towersOf Hanoi (N- 1, from, spare, to, indent+2); 

mo ve One (f r o m, to, indent+2); 


t o we r s Of Ha n o i (N- 1, spare, to, from, indent+2); 

} 

} 


pr i vate voi d mo v e On e ( i nt f r o m, i nt t o , i nt i n d e n t ) 

System, out. f o r ma t ( " %" + (i n d e n t + 8 ) + “ s \ n" , 
f r o m + " - - - > " + t o ) ; 


} 


{ 


15.5 Quicksort 

We will present a sorting algorithm that uses recursion in this section. This sorting 
algorithm is called quicksort, and we will compare the performance of quicksort 
against that of the previous two sorting algorithms at the end of this section, to ver¬ 
ify that quicksort deserves its name. 
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low 


high 


A ny element can be used as 
a pivot. For simplicity, weuse 
number[low] as pivot p. 


p 



#90 




1 

partition 

number[i]<p 1 p<number[i] 

A r ---, 


P 



i I i 

Quicksort m id Quicksort 

I I 

♦ i 


Figure 15.4 The core idea of the quicksort algorithm. 

Figure 15.4 illustrates the core thinking of quicksort. To sort an array from 
index low to high, we first select a pivot element p. Wecan select any elementin the 
array as a pivot, but for simplicity, we choose number[low] as the pivot. Using p as 
the pivot, we scan through the array and move all elements smaller than p to the 
lower half (left half in the figure) and all elements larger than p to the upper half. 
Then we sort the lower and upper halves recursively, using quicksort. The variable 
mid points to the position where the pivot is placed. So the lower half of the array is 
from index low to mid-i, and the upper half of the array is from index mid+i to high. 
The recursion stops when the condition low >= high becomes true. 

H ere's the quicksort algorithm: 

pubi i c voi dquickSort(int[] number, int low, int high) { 

if (low < high) { 

int mid = parti ti on(number, low, high); 

qui ckSort(number, low, mi d- 1 ); 

qui ckSort(number, mid + 1, high); 

} 

} 

The partition method splits the array elements number[low] to number[high] 
into two halves, as shown in Figure 15.4. Weusenumber[low] as the pivot element. 
The method returns the position where the pivot element is placed. Figure 15.5 
shows the result of partitioning the array by using the element 23 as a pivot. 

We first set the pivot to number[low]. Then we start looking for a number 
smaller than the pivotfrom position high, high-i, and so forth. Let's say the number 
is found at position j. Since this number is smaller than the pivot, we move it to posi¬ 
tion low. Now we start looking for a number larger than the pivotfrom low+i, low+2, 
and so forth. Let's say the number is found at position I. We move it to position J. We 
then repeat the process, this time looking for a number smaller than the pivotfrom 
j-i, J-2, and so forth. Figure 15.6 shows the details of the partitioning process. 
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start 


end 


23 

17 

5 

90 

12 

44 

38 

84 

77 


partition 

I 

3 4 5 


12 

17 

5 

23 

90 

44 

38 

84 

77 


mid 


Figure 15.5 Result of partitioning using 23 as a pivot. 


Here's the partition method: 

pri vate i nt partition (i nt[] number, int start, int end) { 
II set the pi vot 
int pivot = number [start ]; 

do { 

II look for a number smaller than pivot from the end 

whi I e (start < end && number [end] >= pivot) { 
end- - ; 

} 

if (start < end) {//found a smaller number 
number [start 1 = number [end]; 

II now find a number larger than pivot 
//from the start 

while (start < end && n u mb e r [s t a r t ] <= pivot) { 
s t a r t ++; 

} 

if (start < end) {//found a larger number 
number [end] = number[start]; 

} 


} whi le (start < end); 

II done, move the pivot back to the array 
number [start ] = pivot; 

return start; 
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start 


end 


pivot = number!start] ; 


V\hi I e ( number! end] > pivot) { 
end—; 


number[start] = number[end] ; 


V\hi I e ( number[ start] < pivot) { 
start++; 


number[end] = number!start]; 


V\hi I e ( number! end] > pivot){ 
end—; 


number!start] = pivot; 


Result 
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Figure 15.6 Details of one partitioning. 
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subarrays 

sub array 

Level no. 



at level i 

at level i 

0 

1 

i 
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N = N/ 2° 

1 

i i r 

i 

2 = 2 1 

N/2 = N/2 1 


/\ 

/\ 



2 

• 
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i 
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• 

N/4 = N/2 1 

• 

• 

K 

■ a aa 

tfb 

• 

N 

• 

1 = N/2 k 


Figure 15.7 A hierarchy of partitioning an array into smaller and smaller arrays in the quicksort. 


How good is quicksort? Does the algorithm execute a fewer number of 
comparisons than the selection or bubble sort? The answer is no in the worst 
case. Quicksort executes roughly the same number of comparisons as the selec¬ 
tion sort and bubble sort in the worst case. When the original list is either already 
sorted or in descending order, then after a partition process, either the lower half 
or the upper half has N - 1 elements. The effect is the same as that of the previ¬ 
ous two sorting algorithms; that is, either the smallest or the largest number 
moves to its correct position. The worst situation can be improved somewhat if 
we select the median of three numbers, say, numberflow], numberfhigh], and 
number[(low+high)/2], as the pivot element. Even with this improvement, the 
number of comparisons in the worst case is still approximately the square of the 
size of the array. 

Is the name quicksort a kind of false advertisement? Not really. On average, 
we can expect a partition process to split the array into two subarrays of roughly 
equal size. Figure 15.7 shows how theoriginal array is partitioned into smaller sub¬ 
arrays. When the size of all subarrays becomes 1, then the array becomes sorted. At 
level i, there are 2' subarrays of size N/2'. So there will be N/2' partition processes 
at level i. The total number of comparisons of all those partition processes at level i 
is therefore 2' • N/2' = N. Sinee there are AT Ievels, the total number of comparisons 
for sorting the whole array is 


K-N 


but 


n = 2 k 
log 2 N = K 


so 


KN = N\og 2 N 

The total number of comparisons is proportional to Ar log 2 TV, which is a great 
improvement over N 2 . A more rigorous mathematical analysis will show that the 
quicksort on average requires approximately 2AMog 2 N comparisons. 
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w 

Quick 

CHECK 


1. Partition the following arrays, using the partition method. 


0 

1 

2 
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44 
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24 

45 


15.6 


When Not to Use Recursion 


Recursion is a powerful tool to express complex algorithms succinctly. For example, 
writing a nonrecursive algorithm for the Towers of Hanoi is unexpectedly difficult. 
Likewise, a recursive quicksort algorithm is easier to understand than its nonrecur¬ 
sive counterpart. For both problems, we prefer recursive algorithms because recur¬ 
sion is the most natural way to express their solution. However, just being natural is 
not the criterion for selecting a recursive solution over a nonrecursive one. 

Consider a solution for computing theTVth Fibonacci number. A Fibonacci 
number is defined recursively as 


if N = 0 or N = 1 


fi bonacci(N) 


f i bonacci(N- 1) 

+ fi bonacci (N-2) other wise 


Because the function is defined recursively, it is natural to implement the function 
by using a recursive method. 

publ ic int fi bonacci (i nt N) { 

if (N == 0 || N == 1) { 

return 1; lie nd case 

} el se {//recursive case 

return f i b o n a c c i ( N- 1 ) + fi bonacci (N-2); 

} 

} 

This recursive method is succinct, easy to understand, and elegant. But is this 
the way to implement it? The answer is no, because the recursive method is grossly 
inefficient and a nonrecursive version is just as easy to understand. The method is 
i neffici ent because the same val ue i s computed over and over. F i gure 15.8 shows the 
recursive calls for computing the fifth Fibonacci number. Notice that the same 
value, for example, fibonacci(2), is computed repeatedly. 
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Figure 1 5.8 Recursive calls to compute fibonacci(5). 


The Mh Fibonacci number can be computed by using a nonrecursive 
method. 


publ ic int fi bonacci (i nt N) { 

intfibN, fibNl, f i b N 2, c n t; 

if (N == 0 || N == 1) { 

return 1; 

} el se { 


fibNl = fi b N 2 = 1; 
c nt = 2; 



} 

The nonrecursive method is not as succinct as the recursive version, but at the 
same time, it is not that difficult to understand. The nonrecursive version is much 
more efficient, and it is the one that should be used. This nonrecursive version is 
written in such a way that its structure parallels the structure of the recursive 
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version, so we can compare the two easily. It is possible to rewrite the nonrecursive 
version with a simple for loop as 

pub) ic int fi bonacci (i nt N) { 

i nt f i b N1, f i b N2, f i b N; 

f i b N = f i b N1 = f i b N2 = 1; 

for { i nt i =1; i < N; i + + ) { 

f i b N = f i b N1 + f i b N 2; 

f i b N1 = f i b N2; 
f i b N2 = f i b N; 

} 

return f i b N; 

} 

Let's look at another example where recursion should not be used. Consider 
the following method: 

pr i vat e voi d mainControl ( ) { 

System, out. pri ntl n("l. Search Stores"); 

System, out. pri ntl n("2. Floor Maps"); 

System, out. pri ntl n("3. Food Court Information"); 

int choice = s c a n n e r. n ex t I n t () ; 
process(choice); //assume input is correct 
mai nControl {); //recursive call 


} 

The idea behind the method is to display menu choices and process the selected 
operation. We assume that this program is a dedicated software for an information 
kiosk at a shopping mall. Once started, the program does not terminate. The sys¬ 
tem administrator can still terminate the program by other ways and means (such 
as switching off the machine itself), but the end user does not have a menu choice 
to terminate the program. 

Recursion seems natural at first for such top-level control that repeats itself 
indefinitely. But there's a serious problem. It will eventually results in memory 
overflow. Every time a recursive call is made, a data segment is allocated to store 
local variables (and other pieces of data). This data segment gets deallocated only 
when the execution of a method terminates. Because there's no test inside the 
mainControl method to stop the recursive calls, each execution of mainControl 
never returns. So the allocated data segments never get deallocated. Thus, the 
memory overflow will eventually occur. 
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A solution to this problem is remarkably simple: implement the method with 
an infinite loop as such 

pri vate voi d mai nCont r ol ( ) { 
whi I e (true) { 

System, out. pri ntl n("l. Search Stores"); 

System, out. pri ntl n("2. Floor Maps"); 

System, out. pri ntl n(" 3. Food Court Information"); 

i nt choice = s c a n n e r. n ex t I n t (); 

process(choice); //assume input is correct 

} 

} 

This method is executed exactly once, so only one data segment is allocated. The 
execution of the modified method, therefore, will never result in memory overflow. 

There is no clear-cut rule to determine whether a routine should be imple¬ 
mented recursively or nonrecursively. In general, we should always search for a 
nonrecursive solution first. We should use recursion only when a recursive solu¬ 
tion is more natural and easier to understand and the resulting method is not too 
inefficient. We repeat the guideline for using recursive methods we mentioned in 
Chapter 6. 



[•Ill 

Use recursion if 

1. A recursive solution is natural and easy to understand. 

2. A recursive solution does not result in excessive duplicate computation. 

3. The equivalent iterative solution is too complex. 


Summary 


Recursion is a special type of repetition control. 

A recursive method is a method that calls itself. 

A recursive method consists of a test to stop the recursion, the end case that 
gets executed at the end of recursion, and the recursive case that makes a 
recursive call to continue the recursion. 

The use of recursion should be avoided if a suitable nonrecursive looping 
statement can be developed. 


Key Concepts 


recursive methods recursive cases 

end cases 
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5 E 


Review Exercises 


1. In Chapter 6, we gave the nonrecursive and recursive solutions for finding 
the greatest common divisor of two given integers. Which version is the one 
you should use in practice? 

2. Whatwould happen if the anagram method were called initially by passing 
an empty string as the second parameter as 

a n a g r a m( "" , "" ) ; 


Will the method work? Why or why not? If not, correct the problem. If yes, 
then would it be logical to leave it as is, or should the method be corrected to 
make it more logical? 

3. What is a potential problem with the following recursive method? 
pri vateint get I nput ( ) { 

System, out. printlnf" Enter Positive Integer: "); 
int val = scanner, next I nt (); 


if (val <= 0) { 

System, out. p r i n 11 n (" Input Error. Try Again, 
return ge t I n p ut (); //recursive call 


} el se { 

return val; //input okay, 


); 


so return it 


Level 1 Programming Exercises ★ 

4. The partition method of quicksort selects the first element as its pivot. 
Improve the method by using the median of the values in the first, the 
middle, and the last elements of an array. If an array number to partition has 
8 elements indexed from 0 to 7, then the first element is number[0], the 
middle element is number[4], and the last element is number[7]. If these 
elements are 55, 34, and 89, for example, then the median is 55. 

5. Write a recursive method that counts the number of characters in a given 
string, that is, implement the length method of the string class using recur¬ 
sion. Write a simple control program to test this method. Note: This is strict¬ 
ly an exercise. U nder normal circumstances, you never want to reimplement 
a method already included in theJava API. 

6. W rite a recursive method to find the smallest element in an array. The method 
accepts an array and the index position of the next element to process. 

Note: This is strictly an exercise. You should not write the real method 
recursively. Write a simple control program to test this method. 
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7. Write a recursive method to compute the sum of the elements in an array. 
The method accepts an array and the index position of the next element to 
process. Note: This is strictly an exercise. You should not write the real 
method recursively. Write a simple control program to test this method. 

8. Write a recursive method to reverse a given string. The method accepts a 
string as an argument and returns the reverse of the argument. For example, 
if the argument is Java, then the method returns avaJ. Show this method be 
written recursively or nonrecursively in practice? Write a simple control 
program to test this method. 

Level 2 Programming Exercises ★★ 

9. Write a recursive method to determine whether a given string is a 
palindrome. A string is a palindrome if it reads the same both forward and 
backward. Ignore the case of theletters and punctuation marks. Writea 
simple control program to test this method. 

10. Writea recursive binary search method. Should this method be written 
recursively or nonrecursively in practice? Write a simple control program 
to test this method. 

Level 3 Programming Exercises ★★★ 

11. Another recursive sorting algorithm is called merge sort. The merge sort 
divides the array into two halves, sorts the two halves recursively using 
mergesort, and finally merges the two sorted halves into a sorted list. In a 
diagram, the process of mergesort looks like this: 
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Write the mergesort method. Writea simple control program to test this 
method. 
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Exercises 901 


12. You can visualize the growth of a tree recursively. Firstyou startwith a 
trunk of a set length: 


From this trunk, two branches grow out: 



Now if you consider the two branches as the trunks of their respective 
subtrees, you have another growth, resulting in 



Continue this recursive growth, and you will end up with a tree that looks 
something like this: 



The length of the branch will get shorter and shorter. Once the length 
becomes shorter than some preset value, the recursion stops. Also, as you 
can see from the tree above, you should use some form of probability 
whether the branch will continue to grow or not. Try first the fixed 
probability of 0.9. Experiment with others, such as the probability of growth 
as a function based on the length of the branch. Techniques for basic 
drawing are explained in Chapter 5. 
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Appendix A 

How to Run Java Programs 


This appendix is intended for those who need to install necessary tools on their com¬ 
puter. Those who have an access to a computer lab with the necessary tools already 
installed may still want to read this appendix for general information. 

In this appendix, we will explain a number of different ways of running Java 
programs. They can be divided broadly into three categories: minimalist, enhanced 
editor, and full integrated development environment (IDE). For the beginning pro¬ 
grammers, we recommend the enhanced editor approach. 


Lj^ings to Remember 

Please read Chapter 2 before this appendix. 



At the end of this appendix, we will describe how to use classes from 
programmer-defined packages, such as the author-provided javabook package, in 
running your programs. 

The Minimalist Approach 

In this approach we use the absolute minimum to compile and run J ava programs. 
We need to download a necessary compiler and other tools for compiling and 
running J ava programs from the Sun M icrosystems website at http://java.sun.com. 
A collection of tools for compiling and running Java programs is called a Java 2 
SDK (Software Development Kit). Sun also uses the term JDK instead of SDK. 
JDK stands for J ava Development Kit. Sun M icrosystems provides three versions 
forSDK: enterprise edition (J2EE SDK), standard edition (J2SE SDK), and micro 
edition (J 2M E SDK). The one you need to download is the standard edition. We 
describe the steps for the M S Windows platform here. 

1. Installation 

Download the most recent version Java for M S Windows. At the time of this 
writing (November, 2008), the most recent version is J DK 6 Update 10. The 
website for downloading it is 

http://java.sun.com/javase/downloads/index.jsp. 
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Please be aware that website addresses change frequently. If the given address 
does not work, you can search for the correct page starti ng from the J ava home- 
page at http://java.sun.com. 

Click the Download button next to the column heading Java SE Develop¬ 
ment Kit (JDK) 6 Update io. T hi s wi 11 take you to another page w here you spec¬ 
ify the Platform and the Language. Select Windows from the drop-down listfor 
the Platform. (You have no choice but Multi-language for the Language selec¬ 
tion.) Click the checkbox for I agree to the Java SE Development Kit 6 Licence 
Agreement. Finally, click the Continue button. 

In the next page, you'll see a link labeled jdk-6uio-windows-i586-p.exe. 
Click this link. It will initiate the process of downloading the installation file. 
Download the file to any location of your choice on the hard disk. This file has 
the filename jdk-6ui0-windows-i586-p.exe, same as the link label. Once the 
download is complete, double-click the file to begin the installation. You may 
choose any directory for installation. In this example, we assume the tools are 
installed in the directory 

C:\java6 

You may change it to any name and location you like. When the installation 
completes successfully, you will see a number of subdirectories, such as bin 
and lib, under the installation directory. 

2. C reate a Program 

Wearenow ready to create a program. Using Notepad (or any other text edi¬ 
tor, but don't use a word processor that saves special markers with a docu¬ 
ment), create the following program: 

import javax. swing.*; 
class MyFi rstProgram { 

public static void mai n(Stri ng[] arg) { 

J Opti onPane.showMessageDi al og(nul I , "It works!"); 
System. exit(O); 

} 

} 

Type in the program exactly as shown, making sure the uppercase and lower¬ 
case letters are entered correctly. Note: A simple text editor, such as Notepad, 
will display the code in black only. 

3. Save the Program 

Before we compile and run the program, let's save the program. First create a 
folder. [Note: We use the words folder and directory synonymously.) For this 
example, we will create a folder named JavaPrograms under the C: drive. 

C: \ J avaPrograms 

Save the program by selecting the menu choice File/Save of Notepad and 
giving the name MyFirstProgram.java. Put this file in the C:\JavaPrograms 
folder. The name Of the class is MyFirstProgram, SO we save it as MyFirstPro¬ 
gram.java. If you name the program xyz, then save it asxYZ.java. Note that it 
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is case-sensitive. W hen you use N otepad, be careful that the file is not saved 
as MyFirstProgram.java.txt. M ake sure there's no txt suffix appended to the 
filename. To avoid the automatic appending of the txt suffix, don't forget to 
set the value for Save as type to All Files. 



4. Open a Command Prompt Window 

After the source file is created and saved properly, we are ready to compile 
and run it. We use a command prompt window to enter the commands for 
compiling and running Java programs. Open a command prompt window by 
selecting the start/Run... option 



^Jstart & <0 E3 ^ fl 
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and entering the text cmd in the text field of the Run dialog box (if cmd does 
not work, try command): 


Run 


JLJxJ 



Type the name of a program, folder, document, or 
Internet resource, and Windows will open it for you. 


Open: | cmd 


3 


OK I Cancel Browse... 


Click the ok button. A command prompt window appears on the screen: 



From this point on, all commands are entered in this window. 

5. Set the Environment 

Before we can actually compile and run the program, we must set the environ¬ 
ment. F i rst change to the JavaPrograms di rectory where the source file is stored 
by entering the command cd JavaPrograms (and pressing the Enter key): 


C:\> cd \JavaPrograms 
C:\javaProgra ms > 


Note: The text we enter is shown in blue. The prompt displayed by the com¬ 
puter is shown in black. 

Note: It is beyond the scope of this appendix to explain DOS commands. 
Please consult other sources if you need to learn DOS commands. 
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Enter the following two commands in sequence to set the environment: 


C:\javaProgra ms >set path=C:\java6\bi n 
C: \ j a v a P r o g r a ms >s e t cl asspath = . 

C: \ J avaPrograms> 


Enter the commands exactly as shown. Do not introduce any spaces between 
the equals symbols (=), for example. The first command sets the PATH envi¬ 
ronment variable so we can refer to the executable files in the bin subdirectory 
of C:\java6. The second command tells the Java compiler and interpreter 
where to find the source files. The period (.) indicates the current directory. 
You need to enter the two commands only once. 

6. Compile the Program 

Finally we are ready to compile the program. To compile a Java source file, 
use the javac command followed by the filename of the source file. Enter the 
following command exactly, that is, in a case-sensitive manner: 


C:\javaProgra ms >j a v a c MyFi rstProgram. java 


After a moment of pause, when there's no error in the program, the prompt to 
enter the next command appears. A n error message wi 11 appear if there's an error. 

I f that happens, go back to N otepad and check the program. M ake any necessary 
changes and save it again. Then enter the javac command again. As explained in 
Chapter 2, successful compilation will result in a creation of a bytecode file. 

7. Run the Program 

After the successful compilation of the program, we are finally ready to run 
the program by executing its bytecode file. To run the program, we use the 
java command followed by the name of the bytecode file (with no suffix). 
Enter the following command and press the Enter key: 


C:\JavaPrograms> java MyFi rstProgram 


The program starts and a message dialog appears on the screen: 



Close this message dialog by clicking its ok button. 

Congratulations! You have successfully executed your first Java program. 
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The Significance of the System.exit Statement 
The last statement of the sample program was 

System, exit(O); 

which caused the program to terminate. If you adopt the minimalist approach of using 
Notepad (or another simple text editor) and a command prompt window, you must in¬ 
clude the exit statementto terminate thesampleMyFirstProgram program. If you don't, 
then the program will not terminate. The message dialog disappears from the screen 
when you click its ok button, but the program is still active. When this happens, you 
will not get another prompt in the command prompt window. And, of course, without 
getti ng a command prompt, you can't enter another command anymore. N ot al I pro¬ 
grams behave in this way. Specifically, a program that uses console-based standard 
input and output does not require the exit statement, while a program that uses GUI- 
based input and output (such as MyFirstProgram that uses the G UI -based JOptionPane 
for output) requires the exit statement. When you are using the minimalist approach, 
the easiest thing to do is to include the exit statement for all programs. 


The Enhanced Editor Approach 

Fora very si mpl e program, the mi ni mal i st approach may be an acceptable alternative. 
However, when the programs we develop become larger, the minimalist approach be¬ 
comes cumbersome. Unlike with the minimalist approach in which we have to deal 
with separate tools for editing (Notepad) and running (command prompt) programs, 
with the enhanced editor approach, we interact with a single tool that will let us edit, 
compile, and run Java programs. For the beginning programmers, we recommend the 
enhanced editor approach. 

There are a number of good software tools that fall under this category. Some 
of the more well-known ones are 

• jGrasp (www.eng.auburn.edu/grasp) 

• TextPad (www.textpad.com) 

• jEdit (www.jedit.org) 

• JCreator (www.jcreator.com) 

• BlueJ (www.bluej.org) 

You can look for other enhanced editors by visiting Google and entering the search 
text "Java editors.” M ost of these tools are available free or for a nominal fee. The 
enhanced Java editors are diverse in user interface style and the options they sup¬ 
port, but they share two key features: 

1. Support of color syntax highlighting. Different portions of the code are dis¬ 
played in different colors (reserved words in blue, comments in green, string 
constants in cyan, and so forth). 

2. U seof J ava SDK. The enhanced editors provide us with an environment where 
we can enter, compile, and run J ava programs, but the actual compilation and 
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execution of programs are done by J ava SDK tools (javac, java, etc.). I n other 
words, instead of dealing with Java SDK tools directly by entering commands 
in the command prompt window, we deal with them by selecting correspond¬ 
ing menu choices of the enhanced editor. 

Since we cannot describe the enhanced editors adequately in a limited space, 
we refer you to their respective websites for instructions on how to use them. 

The IDE Approach 

Tools in the IDE approach are geared toward serious programmers developing 
large-scale programs. Eclipse and NetBeans are two well-known full IDEs. Inaddi¬ 
tion to many features, they typically include a visual editor that lets programmers 
design the user interface of a program visually by dragging and dropping GUI 
objects from the component palettes. They are complicated, and it takes time to 
master and use the various features supported by them properly. For this reason, this 
approach is not recommend for beginning programmers. 

Using Programmer-Defined Packages 

When we are using classes from the system packages such as javax.swing, java.util, 
and others, all we do is to include appropriate import statements in the program. 
This is not enough when we are using classes from programmer-defined packages. 
We must also set the environment correctly. How we set the environment is depen¬ 
dent on the development tools we use. We will describe how to set the environment 
to use programmer-defined packages with the minimalist approach. Please consult 
the relevant user manual for information on using programmer-defined packages 
with the enhanced editor approach. 

We will use the author-provided galapagos package as an example to illus¬ 
trate the procedure. You can download this package and its documentation 
from the textbook website. We assume you have downloaded and installed the 
galapagos classes under the C:\JavaPrograms\galapagos directory. Notice that 
the name of the package is galapagos, and the directory that contains the classes 
in this package is also named galapagos. This is the requirement. The classes in 
the package xyz must be placed in the directory named xyz. The directory xyz, 
however, can be placed anywhere you want. In this example, we put the 
galapagos directory under C:\JavaPrograms. When the installation is done cor¬ 
rectly, you should see the source and bytecode files of the galapagos classes in 
the C:\JavaPrograms\galapagos directory. 


I hings to Remember 

For this example, we assume that the classes from the author-provided galapagos 
package are placed in the directory. 

C:\JavaProgra ms \ g a I a p a g o s 
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All you have to do is to change the setting for the class path as follows: 

set classpath=,;c:\JavaPrograms 
Notice that we specify the directory that contains the galapagos directory. 


hings to Remember 


To use the galapagos classes stored in the directory C:\Javaprograms\galapagos, 
set the class path by entering the command. 

set cl asspath=. ; c:\J avaPrograms 
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Sample Programs 


In this appendix, we provide a chapter-by-chapter list of all sample classes (pro¬ 
grams). For each sample class, we provide a brief description, the page number 
where the class is listed or discussed, and a list of system classes used by this 
class. You can download the source files of all sample classes (programs) from the 
M cGraw-Hill book website at http://www.mhhe.com/wu. 

Chapter-by-Chapter List 

The single asterisk means only the fragment of the program is listed in the main text. 
T he doubl e asteri sks mean the program i s not I i sted i n the mai n text. Such programs are 
provided as additional examples or variations on the programs listed in the main text. 


<chapter #> 


Name 

Page # 

Standard Classes 

<class name> 

<page # 

<list of standard classes or interfaces used 


where the 

or referred to in the class> 


class is 

Note: Unless the String class is the major 


listed> 

focus of a program, it will not be listed in 
this column. Also, System will not be listed. 


<A brief description of the class> 
<class used in the sample development 


CHAPTER 2 

Class Name Page # Standard Classes 

Ch 2 S a mp I e 1 31 j F r a me 

This program opens a simple JFrame window. 

Ch2Stri ngProcessi ng 59 String 

Illustrates string processing with the substring, indexof, and length methods of the String 
class. 
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Chapter 2 (Continued) 

Class Name Page # Standard Classes 

Ch2DateDi spl ay 62 Date 

Si mpI eDat eFor mat 

Creates and displays today's date in two different styles: one in the format 1/19/09 9:20 AM 
and another in the format Monday January 19,2009. 

Ch2Greeti ngs 67 String 

Scanner 

Accepts a name as a string input and replies with a greeting. 

Ch2RecordFiIi ng 68 Scanner 

Input first and last names individually and display the name in the last name, first name format. 

Ch2Monogr am 72,74 String 

Scanner 

A class in the Chapter 2 sample development program that accepts a full name as a string input 
and displays the monogram of the input name. 


CHAPTER 3 

Class Name Page# Standard Classes 

C h 3 C i r c I e 103 String 

Assigns a value to a radius and displays the circle's area and circumference. 

Ch3Ci rcl e 2 * * N/A St ri ng 

De c i ma I F o r ma t 

Same as Ch3Cirde, but restricts the fractional values to three decimal places when displaying 
the area and circumference. Formatting of the double values is done by using the 

DecimalFormat class. 

C h 3 C i r c I e 3 106 String 

De c i ma I F o r ma t 

Same as Ch3Cirde2 but with additional formatting with control characters. 

Ch3Ci rcl e4 112 Scanner 

Same as Ch2Cirde3 but inputs a value for the radius using the Scanner class. 

Ch3 PoI eHei ght 116 DecimalFormat 

Ma t h 
Scanner 

Computes the height of a given pole. Illustrates mathematical computation using the class 
methods of the Math class. 
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Chapter 3 (Continued) 

Class Name Page # Standard Classes 

Ch3Sel ectWi nner 119 Scanner 

Random 

This program selects a random number between M and M+N, where M and N are inputs to the 
program. The program uses the Random class to generate random numbers. 

Ch3TestCal endar 122 GregorianCalendar 

Illustrates how to use the GregorianCalendar class for date manipulation. 

Ch3l ndependenceDay 123 GregorianCalendar 

Si mpI eDat eFor ma t 

This program displays the day of the week of a designed date (in this example, we chose 
Independence Day). The date is specified in the program by changing the arguments in the 

GregorianCalendar constructor. 

Ch3Fi ndDayOfWeek 123 GregorianCalendar 

Si mp I e Da t e F o r ma t 
Scanner 

Same as Ch3lndependenceDay but this program accepts year, month, and day as input and dis¬ 
plays the day of the week of the given date. 

Ch 3 L oa nCa I c u I a t o r 128,130, Dec i ma I For mat 

132,134 Math 

Scanner 

Computes and displays the monthly and total payments for a given loan amount, loan period, 
and interest rate. 


CHAPTER 4 

Class Name Page # Standard Classes 

Bi cycl eRegistrati on 152 

This is a sample main class that uses two Bicycle objects. 

Bicycle 153 

A sample programmer-defined class that models a bicycle. 

Sec o nd Ma i n 163 

This sample program shows the use of two programmer-defined classes Bicycle and Account. 
Account 164 

This is the second sample programmer-defined class. It models a bank account. 

Student 168 

This programmer-defined class models a student. 
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Chapter 4 (Continued) 

Class Name Page # Standard Classes 

Li braryCard 169 

This programmer-defined class models a library card. 

Librarian 171 

This main class shows the sample usage of the Student and LibraryCard classes. 

Account Ver 2 175 

A version of the Account class that includes a constructor with two parameters. 

EI e me n t 17 8 

This class models an element in the periodic table. 

AccountVer3 183 

Another version of the Account class. This version illustrates the use of a class constant that 
represents a fee charged for withdrawals. 

Deduct i on Wi t h Fee 184 De c i ma I F o r ma t 

A sample main class that uses the AccountVer3 class. 

Die 186 Random 

A programmer-defined class that models a die.The class shows how a random number between 
1 and 6 is generated by using the random method of the Math class. 

Ro I I Di c e 187 

This is a main class that shows the sample usage of the Die class. 

LotteryCard 188 Random 

A programmer-defined class that models a lottery card. Each card is randomly assigned a 
number between 10 and 15 and one of the three possible colors—red, green, or blue. 

R o o mWi n n e r 189 

This is a main class that shows the sample usage of the LotteryCard class. 

AccountVer4 194 

This is the fourth version of the Account class. This version shows the use of a private method. 

Di eVer 2 195 Random 

This version of the Die class illustrates the calling of a private method from the constructor. 

Bicycle 197 

This version of the Bicycle class includes the main method. This version is stored in a separate 
subfolder to avoid the naming conflict with the original class. 
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Chapter 4 (Continued) 

Class Name Page # Standard Classes 

Loan 204,207,210,211 Random 

An instance of this class maintains three pieces of loan information: amount, period, and interest rate. 

LoanCal cul ator 203,206,209 

The top-level controller class for the loan program. This class is defined as an instantiable main class. 


CHAPTER 5 

Class Name Page # Standard Classes 

Ch5Ci rcl e 229 

This class illustrates the use of if statements. An instance of this class can compute the area and 
circumference of a circle, given the radius. 

Ch5 Sa mpl el 231 

A program to test the operations of the Ch5Circle class. 

Ch5 Ac count 238 

This version of the Account class shows the use of selection control in the add and deduct methods. 

Ch5AccountVer2 245 

This is an improved version of the Ch5Account class. This version includes a boolean data 
member active that records the state of an account—active or inactive. 

Fraction* 249 

A programmer-defined class that illustrates how objects are compared. 

Ch5Sampl eGraphi cs 257 j F r a me 

Gr aphi cs 

This class illustrates how a Graphics object is used by drawing a rectangle and filled rectangle 
on a frame window. 

Ch5Sampl eGraphi cs2 262 J F r a me 

Gr aphi cs 
Color 

This class is the same as the Ch5SampleGraphics class, but draws the rectangles in blue and red. 

Ch5RoomWi nner 264 j F r a me 

Cont ai ner 
Gr aphi cs 

This is the graphics version of the RoomWinner class from Chapter 4. 

GraphicLotteryCard 265 Graphics 

The graphics version of the LotteryCard class from Chapter 4. This class is used by the 
Ch5RoomWinner class. 
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Chapter 5 (Continued) 


Class Name Page # Standard Classes 

Drawabl eShape 279,286,290 Point 

Di mens i on 
Color 
Gr aphi cs 

The class encapsulates the functionalities of a shape that can be drawn. 

D r a wi ngBoard N/A 


This is a helper class given to you as support for implementing this application. 

Ch5Dr awShape 277,280,284, 

289,291 


This is the instantiable main class of the sample development program. 


CHAPTER 6 

Class Name Page# Standard Classes 

Ch6SI eepStati sties 309 Dec i ma I Format 

Scanner 

This program computes the average sleeping time of dorm residents. This program uses 
a while loop. 

C h 6 GC D* 311 Math 

This class shows a number of different ways for finding the greatest common divisor of two 
given integers. 

C h 6 D r oppi ngWat er Mel on 329 Math 

Scanner 

This program inputs the initial height and computes the position of a watermelon every second 
until it touches the ground. This program illustrates the use of the for loop. 

Ch6Compl exForLoops* 330 Math 

This program illustrates the use of complex for loops. 

Ch6Carpet PriceTabl e* 332 

This program illustrates the use of nested for loops. The program outputs the price of a carpet 
ranging in size from 5 by 11 to 25 by 20. 

Ch6Carpet PriceTabl e- 338 

wi t h F o r ma t 

This class modifies the Ch6CarpetPriceTable class by formatting the output values. The format 
is done by using Ch6Format. 
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Chapter 6 (Continued) 

Class Name 

Page # 

Standard Classes 

Ch 6Ti meGcd 

343 

Da t e 



Scanner 


This program illustrates the technique of timing the execution by using the Date class. 
C h 6 Hi L 0 354 


A sample development program that plays the HiLo game. 

Test Random 360 Random 

A simple test program for Step 3 to check the random number generation. 


CHAPTER 7 

Class Name Page # Standard Classes 

Fraction 410 

This sample class models a fraction.The class definition includes almost all the fundamental object- 
oriented concepts covered in Chapters 4 and 7. The class is placed in the package named myutil. 

Ch7Fracti on_Test 1** N/A 

A simple test class that adds two Fraction objects. 

Ch7Fracti on_Test 2** N/A 

Another main class to test the operations of the Fraction class. 

Li braryBook 423 

This class models a library card. 

SteplMain 425 Gregori anCal endar 

The main class to test the step 1 LibraryBook class. 

Step2Main 428 Gregori anCal endar 

Scanner 

The step 2 main class to test the operations of the helper class BookTracker. 

Over DueChecker 430 Gregori anCal endar 

Scanner 

The main class of the sample development program. 
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CHAPTER 8 

Class Name Page# Standard Classes 

Ch8SampI el* 446 Scanner 

This sample program illustrates the throwing of InputMismatchException when an input 
is not an int. 

Agel nputVer1 447 Scanner 

This is the first version of a class that provides methods to input ages. This class includes no 
exception handling routines; i.e., the system will handle any thrown exceptions. 

Ch8Agel nputMai n 448 GregorianCalendar 

Scanner 

A test program to illustrate the behavior of different versions of the age input class. The program 
asks for the user's age and replies with the year in which the user was born. 

Agel nputVer2* 451 Scanner 

The second version of the age input class with the try-catch exception handling. Its getAge 
method will not return until a valid integer is entered. The method includes a while loop that 
repeats until a valid integer is entered. The loop continues while there's a number format exception. 

Agel nputVer 3* 453 Scanner 

The third version of the age input class that improves the second version by throwing an excep¬ 
tion when the input is a negative integer. 

Agel nputVer4 464 Scanner 

In this fourth version of the age input class, a client programmer can set the lower and upper 
bounds of the acceptable input age values. An exception is thrown if the input value is not an 
integer (as in previous versions) or violates the specified bounds. 

Ch8TestAgel nputVer4** N/A 

This driver program tests the behavior of the AgelnputVer4 class. 

Agel nputExcepti on 469 

This is a programmer-defined exception class that includes the designated lower and upper 
bounds and the input value that violates the specified bounds. 

Agel nputVer 5** N/A Scanner 

The fifth version of the age input class is similar to the fourth version.The key difference is the 
throwing of programmer-defined exception AgelnputException when the input value is 
outside the range of specified bounds. 

Ch8Test Agel nput Ver 5 470 

This driver program tests the behavior of the AgelnputVer5 class 

BankAccount 471 

A sample class that specifies assertions in the deposit and withdraw methods. 

Ch8TestAssertMain 464 Scanner 

A driver program to test the behavior of the BankAccount class. 
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Chapter 8 (Continued) 

Class Name Page # Standard Classes 

Resi dent 482 

An instance of this class represents a dorm resident. A Resident object has name, room number, 
and password. 

Door** N/A 

This helper class models the entrance door of a dorm. 

Dorm** N/A 

This helper class models a dorm. A Dorm object maintains a list of Resident objects. 

Ch8Ent ranceMonit or 484 

The main class of the program. 

Sampl eCreateResi dent Fi I e 485 

A simple (self-contained) program to create sample test data for the Ch8EntranceMonitor 
program. 

I nput Handl er 487 

The user interface of the application that accepts the name, room number, and password. 


CHAPTER 9 

Class Name Page # Standard Classes 

Ch9TestChar* 498 

A simple illustration of conversion between char and int. 

Ch9CountVowel s 501 Scanner 

String 

Illustrates basic string processing. The program counts the number of vowels in a given string. 

Ch9CountVowels2 502 Scanner 

St ri ng 

Same as Ch9CountVowels but uses the toUpperCase method to simply the testing. 

Ch9Count Words 504 Scanner 

St ri ng 

The program counts the number of words in a given string. This program has a minor bug 
of counting one more than the actual number of words if there is one or more spaces at 
the end. 
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Chapter 9 (Continued) 

Class Name Page # Standard Classes 

Ch9CountJ ava 506 Scanner 

St ri ng 

This program inputs words (one word at a time) and counts the number of times the word java 
occurs in input (case-insensitive comparison).The program terminates when the word STOP 
(case-sensitive) is entered. 

Ch9Ext r act Words 508 Scanner 

St ri ng 

This programs extracts words from a given string and displays them one word per line. 

Ch9Patt er nMat chi** N/A Scanner 

St ri ng 

A simple illustration of the matches method, a pattern-matching method of the String class. 

Ch9MatchJ avaldenti fi er 512 Scanner 

St ri ng 

This program illustrates the basic pattern-matching technique by showing how to determine 
whether a given input word is a valid Java identifier. 

C h 9MatchPhoneNumber 513 Scanner 

St ri ng 

This program illustrates the basic pattern-matching technique by showing how to determine 
whether a given input is a valid phone number. 

Ch9MatchPhoneNumber PM** N/A Scanner 

St ri ng 
Ma t c he r 
Pattern 

Performs the same task as Ch9MatchPhoneNumber but uses the Matcher and Pattern 
classes. 

Ch9MatchJ aval denti fi erPM 518 Scanner 

St ri ng 
Ma t c he r 
Pattern 

Performs the same task as Ch9MatchJavaldentifier but uses the Matcher and Pattern 

classes. 

Ch9CountJ avaPM 519 Scanner 

St ri ng 
Ma t c he r 
Pattern 

Performs the same task as Ch9CountJava but uses the pattern-matching technique with the 

Matcher and Pattern classes. 


www.it-ebooks.info 





Appendix B Sample Programs 921 


Chapter 9 (Continued) 

Class Name Page # Standard Classes 

Ch9Locatej avaP M 520 

Similar to Ch9PMCountJava but instead of counting the number of occurrences, this program 
displays the locations in the string where the word java is found. 

Ch9Repl aceVowel Wi thX 524 Scanner 

St ri ng 

St r i ngBuffer 

This program illustrates the use of the StringBuffer class by showing how the vowels in a given 
string are replaced by character X. 

Ch9EvenLetter Wo r d s 526 Scanner 

St ri ng 

Stri ngBuffer 

Another sample program illustrating the use of the StringBuffer class. This program extracts words 
with an even number of letters from a given string and creates a new string with these words. 

Ch9GCContent 530 Scanner 

The program determines the GC-content of a given DNA sequence composed of letters A,T,G,and C. 

Ch9Transcri beDNA 531 Scanner 

Transcribes the given DNA into RNA by replacing thymine(T) with uracil(U). 

C h 9 Re ve r se DNA 532 Scanner 

Outputs the reverse sequence of a given DNA. 

FiI eManager** N/A 

This is a helper class for reading from and saving data to a text file. 

Wo r d L i st** N/A 

This is a helper class for maintaining a word list. 

Ch9WordConcordance 537,542,545 Matcher 

Pattern 

This class creates a word concordance for a given document. For each word in the document, the 
number of times the word occurs in the document is kept. 

Ch9WordConcordanceMai n 536,541 Scanner 

Stri ng 

FiI eNot FoundExcepti on 
IOExcepti on 

The instantiable main class of the program. 
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CHAPTER 10 

Class Name Page# Standard Classes 

ChlORai n F a I I 559 Scanner 

The first sample program that illustrates the use of one-dimensional array of numbers. The 
program computes the annual average rainfall and the variation from the monthly averages. 

ChlORai nFalI 2* 561 Scanner 

The variation of ChlORainFall that uses an array of String so the month name is used to prompt 
the user when inputting monthly rainfall averages. The original ChlORainFall uses month num¬ 
ber (1,2, etc.) instead of month names (January, February, etc.). 

ChlORai nFalI Stat 563 Scanner 

More examples of using arrays by showing how to compute various statistics from given 
monthly rainfall averages. 

Person** N/A 

A simple class used by ChlOProcessPersonArray to illustrate how an array of objects is processed. 

ChlOProcessPersonAr ray 573 Scanner 

This class illustrates the processing of an array of Person objects. 

ChlOTestArrayParameter* 582 Scanner 

This class is a collection of methods to show how an array is passed to a method. 

ChlOPayScal eTabI e 594 

This sample program maintains a pay scale table by using a two-dimensional array of double. 

ChlOFri endsLi st* 599 List 

A r r a y L i s t 

A simple program to show how a list of Person objects can be manipulated with an ArrayList. 

BookTracker 604 List 

Li nkedLi st 

The helper class for the Chapter 7 sample development program.This class maintains a list of 
library books. 

Wor dL i s t 607 So r t ed Ma p 

T r e e Ma p 

The helper class for the Chapter 9 sample development program. This class maintains a word list 
to track the number of times each word in the list occurs in a given document. 

Person** N/A 

A logical class that represents a person. This class is the same as the Person class used in the 
regular sample programs. 

AddressBook 611 

This class implements functionalities of an address book for keeping track of persons. The class 
supports insertion, deletion, and search operations. Assertion statements are used in this class. 

TestAddressBook 612,617,620,624 

A test program to check the operations of AddressBook. 
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CHAPTER 11 

Class Name Page # Standard Classes 

SearchRouti nes* 635 

The class defines two search methods—linear and binary search. 

ChllTest Li near Search** N/A 

A driver program to test the linear search method defined in SearchRoutines. 

ChllTest Bi narySearch** N/A System 

A driver program to test the binary search method defined in SearchRoutines. 

Sorti ngRouti nes* 640 

The class defines two sorting methods—selection and bubble sort. 

ChllTest Sel ecti onSort** N/A 

A driver program to test the selection sort method defined in SortingRoutines. 

ChllTest Bubbl eSort** N/A 

A driver program to test the bubble sort method defined in SortingRoutines. 

Heap 651 

This class implements the heapsort sorting method. 

ChllTest HeapSort ** N/A 

A driver program to test the sorting method defined in Heap. 

Addr essBook (interface) 660 

This interface defines the behavior of an address book that maintains a collection of Person 
objects. An address book is capable of adding and removing objects and sorting objects by their 
name or age. 

Person 665 

A logical class that represents a person. The class includes methods to compare its instances. 

Addr essBookVer 1 668 

This class implement the AddressBook interface by using an array of Person objects. Bubble 
sort is used to sort the objects. 

Addr essBookVer 2 675 Arrays 

This class implements the AddressBook interface by using an array of Person objects. For 
sorting, it uses the generic sorting method included in the Arrays class. 

AgeComparator 676 

(inner class) 

The inner class of AddressBookVer2 and AddressBookVer3 that compares two Person objects 
on their ages. 
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Chapter 11 (Continued) 

Class Name Page # Standard Classes 

Name Comparator 677 

(inner class) 

The inner class of AddressBookVer2 and AddressBookVer3 that compares two Person objects 
on their names. 

AddressBookVer3 678 Map 

Ha s hMa p 
Arrays 

This class implements the AddressBook interface by using an array of Person objects. The HashMap 
class is used for managing Person objects and the Arrays class for sorting Person objects. 

TestAddressBookSort i n g * * N/A 

A driver program to test the sorting routine of the address book. 


CHAPTER 12 


Class Name Page# Standard Classes 

Chl2TestJ FiI eChooser 691 J FiI eChooser 

File 

A simple program that shows how to use JFileChooser and File classes. 

j a v a F i I t e r 693 F i I e F i I t e r 

File 


A simple program to illustrate the use of file filter to list only Java source files in a JFileChooser. 

Chl2TestFi I eOutputStream 696 lOException 

File 

Fi I eOutputStream 

A test program to save data to a file using FileOutputStream. 

Chl2TestFi I el nputStream 698 lOException 

File 

Fi I el nputStream 

A test program to read data from a file using FilelnputStream. 


Chl2Test Dat aOut putStream 700 


IOException 
File 

Fi I eOutputStream 
DataOutputStream 


A test program to save data to a file using DataOutputStream. 
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Chapter 12 (Continued) 

Class Name 

Page # 

Standard Classes 

Chl2Test Datal nputStream 

701 

1OExc epti on 

File 

Fi 1 el nputStream 

Datal nputStream 

A test program to read data from a file using DatalnputStream. 

Chl2TestPri ntWri ter 

703 

1OExc epti on 

File 

Fi 1 eOutputStream 

P r i n t Wr i t e r 

A test program to save data to a text file using PrintWriter. 

Chl2Test Buff eredReader 

704 

1OExc epti on 

File 

Fi1 eReader 

BufferedReader 

A test program to read text data from a text file using BufferedReader. 

Chl2Test Scanner 

706 

Fi1 eNotFoundExcepti on 


IOExc epti on 

File 

Scanner 


A test program to read text data from a text file using Scanner. 

Fi I eManager 707 Fi I eNotFoundExcepti on, 

(Ch 9 Helper class) lOException, File, FiI eReader, 

BufferedReader, 

Fi I eOutputStream, Print Wr iter, 
j FiIeChooser 

The helper class for Ch9WordConcordance program used for saving to and reading data 
from a text file. 

Chl2TestObj ectOutputStream 710 lOException 

File 

Fi I eOutputStream 
Obj ectOutputStream 

A test program to save objects to a file using ObjectOutputStream. 

ChlBTestObj ectl nputStream 712 Cl assNotFoundExcepti on, File, 

Fi I el nputStream, 

Obj ect I nput Stream 

A test program to read objects from a file using ObjectlnputStream. 
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Chapter 12 (Continued) 

Class Name 

Page # 

Standard Classes 

Do r m 

714 

FileNotFoundException, 

(Ch 8 Hel per Cl ass) 


1OExcept ion, 



111egalArgumentExcepti on, 


Cl assNotFoundExcepti on, File, 
Fi I el nputStream, 

Obj ectl nputStream, 

Fi I eOutputStream, 

Obj ect Out put St ream, 

St ri ngBuffer 

This helper class for Chapter 8 Sample Development maintains a list of Resident objects. In 
addition, the class supports file input and output operations. 

Chl2J avaVi ewer** N/A J FiI eChooser 

File 

This program displays the content of a Java source file. 

Person** N/A Serializable 

The same class from Chapter 11, but modified to implement the Serializable interface so its 
instances can be saved to a file. 

AddressBook (interface) 660(fromChapter 11) 

The same interface from Chapter 11. 

AddressBookVerl 668 (from Chapter 11) 

The same class from Chapter 11. 

AddressBookSt orage 718,720,722 I OExcepti on, File, 

F i I eOutputStream, 

Obj ect Out put St ream, 

Fi I el nputStream, 

Obj ectl nputStream 

This class provides file input and output services to save to and read AddressBook objects 
from a file. 

TestAddressBookStorage 719 

This class tests the construtor and the setFile method. 

Tes t Add r e s s Bo o k Wr i t e 721 lOException 

This class tests the write operation. 

TestAddressBookRead 723 lOException 

This class tests the read and search operations. 

TestAddressBookFi nal ** N/A lOException 

This class tests the read and write operations. 
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CHAPTER 13 

Class Name Page # Standard Classes 

Pet 734 

This is a superclass of both Cat and Dog. 

Cat 735 

This class models a cat.The class is a subclass of Pet. 

Dog 735 

This class models a dog.The class is a subclass of Pet. 

Ch 13Te s t Ca t And Do g* * N/A 

A sample program that illustrates the use of the Cat and Dog classes. 

Student 738 

This class models a student entity. 

Gr aduat eSt udent 739 

A subclass of Student to model a graduate student entity. 

UndergraduateStudent 740 

A subclass of Student to model an undergraduate student entity. 

Chl3Test St udent s** N/A 

This illustrates a sample processing of the Student class and its subclasses, 

o n e. S u p e r 744 

This is a sample superclass to illustrate the inheritance member accessibility, 

two. Sub 745 

This is a sample subclass of one.Super to illustrate the inheritance member accessibility. 

Cl i ent 746 

This is a sample client class that uses one.Super and two.Sub classes. 

Student** N/A 

A slightly different version of the Student class used in the sample development program. This 
version is declared as an abstract class. 

GraduateStudent** N/A 

A slightly different version of the GraduateStudent subclass used in the sample development 
program. 

UndergraduateStudent** N/A 

A slightly different version of the UndergraduateStudent subclass used in the sample 
development program. 
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Chapter 13 (Continued) 

Class Name Page # Standard Classes 

Out put Wi ndow N/A 

This is a helper class that supports a dialog window for displaying text output. 

Mai nWi ndow N/A 

This is a helper class that models a frame window. The frame window appears at the center of 
the screen. 

ComputeGrades 764,768 File, FiI eReader, BufferedReader, 

770,775 Stri ngTokeni zer, J FiI eChooser 

The main class of the grading program that determines the course grade for graduate and 
undergraduate students using a different formula.To illustrate inheritance, this class is defined 
as the subclass of MainWindow. 


CHAPTER 14 

Class Name Page# Standard Classes 

Ch 14 S ho wMes s a ge Di a I og 791 JOptionPane 

A sample program that illustrates the use of JOptionPane for displaying a text in a dialog 
window. 

Chl4Defaul tj Fra me 794 J F r a me 

A test program to check the default properties of a JFrame object. 

Chl4J FrameSubcl assl 796 JFrame 

A simple subclass of JFrame to illustrate the basics of inheritance. 

Chl4TestJ FrameSubcl ass 797 

A test main class that creates an instance of Ch14JFrameSubclass1. 

C h 14 J F r a me 5 u b c I a s s 2 798 J F r a me 

Same as the Ch7JFrameSubdass1 but this class sets the background of a frame to white. 

Chl4J ButtonFrame 800 JFrame 

J Button 

A subclass of JFrame with two JButton objects. This class only does the layout; no events are 
processed. 

ButtonHandl er 805 J RootPane 

j Button 

Acti onLi stener 

An instance of this class is registered as an action event listener for two buttons in the 

Ch7JButtonEvents frame. 
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Chapter 14 (Continued) 


Class Name Page # Standard Classes 

C h 14 J ButtonEvents 805 J F r a me 

j Button 

This class is an extension of Ch7JButtonFrame by adding event-handling routines. The event 
handler is an instance of ButtonHandler (see below). 


Ch 14J ButtonFrameHandl er 807 


J F r a me 
J Button 

ActionLi stener 


This class places two JButton objects on its frame and handles the action events of the buttons. 
This class combines the functionalities of Ch14ButtonEvents and ButtonHandler. 

Chl4Text Framel 811 JFrame 

J Button 
j Text Fi el d 
ActionLi stener 


This class places two buttons (JButton) and one text field (JTextField) and handles actions events 
generated by these three GUI components. 

Chl4Text Frame2 814 JFrame, J Label , JButton, 

JTextField, Imagelcon, 

ActionLi st ener 

Similar to Ch14TextFrame1, but adds JLabel objects. How an image is added to a JLabel is 
demonstrated in this class. 


Chl4Text Frame3 817 JFrame, JButton, JTextField, 

J TextArea, Border Fact ory, 

ActionLi st ener. 

This class places two buttons, one text field, and one text area. String data entered in the 
text field are added to the strings in the text area when an action event is generated. 

Chl4FI owLayoutSampi e 821 JFrame 

FI owLayout 
j Button 


A sample frame to illustrate the placing of GUI objects with the FlowLayout manager. 

Chl4Border Layout Sampl e 824 j F r a me 

Bor der Layout 
j Button 

A sample frame to illustrate the placing of GUI objects with the BorderLayout manager. 

Chl4Gri dLayoutSampi e 826 JFrame 

BorderLayout 
j Button 


A sample frame to illustrate the placing of GUI objects with the GridLayout manager. 
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Chapter 14 (Continued) 



Class Name 

Page # 

Standard Classes 

Chl4Absol utePositi oni ng 

828 

j F r a me 
j Button 

A sample frame to illustrate the placing of GUI objects with no layout manager, i.e., using absolute 
positioning. 

Chl4Nest edPanel si 

832 

JFrame, JPanel, BorderFactory, 


GridLayout, Border Layout, 
j Button 


A sample frame to illustrate the placing of nested panels with each panel having a different layout 
manager. 

Chl4Nest edPanel s2 834 JFrame, JPanel, Border Fact ory, 

GridLayout, Border Layout, 

JButton, JTextField, J Label 

A redesigned GUI for the HiLo game using nested panels. 

Chl4Ti cTacToeCel I 836 JPanel, J Label, Imagelcon, 

Border Layout, Border Fact ory, 

Point 

An instance of this class represents a single cell in the Tic Tac Toe game board. A standard game 
is 3 X 3 so there are 9 cells. 

Chl4Ti cTacToePanel 838 JPanel 

Mo us e Li stener 

A panel for displaying the Tic Tac Toe game board.This sample class illustrates the use of nested 
panels. 

Chl4J CheckBoxSampi el 840 JFrame, Ac t i o n L i s t e n e r, 

Acti onEvent, JPanel, JButton, 
Border Layout, GridLayout, 

FI owLayout, Border Fact ory, 
j Chec k Box 

A sample frame to illustrate the use of JCheckBox. 

Chl4J CheckBoxSampi e2 842 JFrame, Ac t i o n L i s t e n e r, 

Acti onEvent, I temLi stener, 
ItemAction, JPanel, JButton, 
Border Layout, GridLayout, 

FI owLayout, BorderFactory, 
j Chec k Box 

This is an extended version of Ch14JCheckBoxSample1 that process item events in addition 
to action events. 
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Chapter 14 (Continued) 

Class Name 

Page # 

Standard Classes 

Ch 14J Radi oButtonSampi e 

845 

JFrame, Acti onLi stener, 

Acti onEvent, 1 temLi stener, 
ItemAction, JPanel, JButton, 
BorderLayout, Gri dLayout, 

FI owLayout, BorderFactory, 

J Radi oBut t on 

A sample frame to illustrate the use of JRadioButton. 

Ch 14J ComboBoxSampi e 

848 

JFrame, Acti onLi stener, 


ActionEvent, ItemLi stener, 
ItemAction, j Panel, 
j Button, Border Layout, 

Gri dLayout, BorderFactory, 
j Radi oBut t on 

A sample frame to illustrate the use of JComboBox. 

Chl4J Li stSampI e 852 J F r a me, ActionListener, 

ActionEvent, j Panel, j But t on, 
BorderLayout, Gri dLayout, 

FI owLayout, BorderFactory, 

J ScrolI Pane, JList 

A sample frame to illustrate the use of JList. 

Chl4J SI i derSampi e 855 JFrame, ChangeLi stener, 

ChangeEvent, JPanel, J Button, 
BorderLayout, BorderFactory, 
j SIider 

A sample frame to illustrate the use of JSlider. 

Chl4J MenuFrame 859 JFrame, J Menu Bar, J Menu, 

JMenultem, Acti onLi stener 

A frame class with menus that illustrates the menu action processing. 

Chl4Tr ackMouseFr ame 864 JFrame 

MouseLi stener 
System 

This program tracks the mouse click events. When a mouse button is clicked, the location where 

the mouse button is clicked is displayed. 

Chl4Sket chPad 867 J F r a me 

MouseLi stener 
Mo use Mo 11 onLi stener 

This program provides a freehand drawing by tracing the mouse movements. 
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CHAPTER 15 

Class Name Page# Standard Classes 

C h 15 AI gor i t hms* 882,883,886,889,891,892 

This class includes a collection of recursive algorithms discussed in Chapter 15. 
TestChl5AI gorit h ms * * N/A 

A driver program fortesting algorithms in Ch15Algorithms. 
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Appendix C 

Standard Classes and Interfaces 


In this appendix, we provide a list of standard J ava classes and interfaces used in the 
textbook's sample programs. Many of these classes and interfaces are discussed 
fully in the book and used extensively in the sample programs, while some are men¬ 
tioned briefly and used only in a few sample programs. For a subset of these classes 
and interfaces, we provide a brief summary and a list of key methods. 

Alphabetical List 

Standard J ava cl asses and i nterf aces menti oned i n thi s book are I i sted al phabeti cal I y. 
The interfaces are shown in italic font. 


Alphabetical List 

Acti onEvent 

Do u b1 e 

1 nputStrea mR e a d e r 

ActionList ener 

Exc epti on 

1 nt eger 

Ar r ay Li s t 

File 

1 OExc epti on 

Arrays 

F i 1 e F i 1 t e r 

1 t e mE v e n t 

BorderFactory 

Fi 1 el nputStream 

1 t emLi st ener 

Bor der Layout 

Fi1 eNot FoundExcepti on 

j Button 

Buffer edReader 

Fi 1 eOutputStream 

j CheckBox 

ChangeEvent 

Fi1 eReader 

j Fi1eChooser 

ChangeListener 

Float 

j F r a me 

Cl assNotFoundExcepti on 

FI owLayout 

j Label 

Col or 

Gr a ph1 c s 

J Li st 

Datal nputStream 

Gregori an Cal endar 

j Me n u 

DataOutputStream 

Gri dLayout 

j Me n u Ba r 

Dat e 

Has h Ma p 

j Me n u 1 t e m 

Dec i ma 1 Fo r mat 

1 1 1 egal Argument Except i on 

J Opt 1 onPane 

Di mens 1 on 

1 ma g e 1 c o n 

j Panel 


933 
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Alphabetical List (Continued) 

j PasswordFi el d 

Ma t c he r 

Pr i nt Wr i t er 

j Radi oBut t on 

Ma t h 

Random 

j Root Pane 

Mo us e E ve nt 

Scanner 

j S c r o 1 1 P a n e 

Mo useListener 

Seri a 1izabl e 

j S1i der 

Mo us e Mot i o n L i s t e ne r 

Si mp 1 eDa t eFor mat 

j Text Ar ea 

NumberFormat Excepti on 

SortedMap 

j Text Fi e1 d 

Obj ec11 nputStream 

St ri ngBuffer 

Li nkedLi st 

Obj ect Out put St r earn 

String 

List 

Pattern 

St ri ngTokeni zer 

Long 

Point 

System 

Map 

Pr i nt St r ea m 

Tr ee Ma p 


Logical List 

The foil owing list organizes the standard cl asses and interfaces from the alphabetical 
list in logical groups. 


Logical List 

Color 

Drawing 

Di mens i on 

Gr aphi cs 

Point 



Acti onEvent 

Events 

Acti on Li stener 

ChangeEvent 

Change Li stener 

1 t emEvent 

1 temLi stener 

Mo us e E ve nt 

Mo us eLi s t e ne r 

MouseMotionListener 

Cl assNot FoundExcepti on 

Exceptions 

Excepti on 

FileNotFoundException 

1 1 1 egal ArgumentExcepti on 

1OExcepti on 

Number Format Except i on 

Buf f er edReader 

File Input and Output 

Datal nputStream 

DataOutputStream 

File 

F i 1 e F i 1 t e r 

FilelnputStream 
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Logical List (Continued) 

Fi1 eOutputStream 

Fi1 eReader 

1 nputStrea mR e a d e r 

Obj ectl nput St ream 

Obj ec t Out put St r ea m 

Pr i nt St r earn 

P r i n t Wr i t e r 

Serializable 


BorderFactory 

GUI 

Bor der Layout 

FI owLayout 

G r i d L a y o u t 

1 ma g e 1 c o n 

j Button 

j Chec kBox 

j Fi1 eChooser 

j F r a me 

J Label 

J Li st 

j Me n u 

j Me n j Ba r 

j Me n u 1 t e m 

j Opt 1 onPane 

J Panel 

j PasswordFi el d 

j Radi oBut t on 

J Root Pa ne 

J Sc r o11 Pane 

J SIider 

j Text Ar ea 

j Text Fi e1 d 


Ar r ay Li s t 

Java Collection Framework 

Has hMa p 

LI nkedLi s t 

List 

Map 

SortedMap 

T r e e Ma p 



Arrays 

Utility 

Da t e 

Dec i ma 1 Fo r ma t 

Gregori an Cal endar 

Ma t c h e r 

Ma t h 

Pattern 

Random 

Scanner 

Si mpl eDat eFor mat 

Stri ngBuffer 

Stri n g 

Stri ngTokeni zer 

System 


D o u b 1 e 

Wrapper 

Float 

1 nt eger 

Long 




Class Hierarchy for Swing Components 

M any of the methods we use for various Swing-based components are defined in 
the common superclass. Instead of repeating the same information in individual 
classes, we will list the methods in the class in which they are defined. Here is the 
inheritance hierarchy for the Swing components mentioned in the book (classes 
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summarized in the next section are shown in blue): 


java.lang.Object 

A 

— j ava.awt.Component 

a, 


java.awt.Container j ava.awt.Window 

A A 

' i a v a x . s wi n o . I C o mn o n p n t 1 


- j avax, swi ng.J Component 

A 


j ava.awt.Frame 


A 

stractButton I— 


— j avax. swi ng.Abst 

A 

- javax.swing.JButton 

- javax.swing.JMenuItem 

1 - javax.swing.JMenu 


- javax.swing.ToggleButton 

A 

- javax.swing.JCheckBox 

- javax.swing.JRadioButton 

-j avax. swing, text. JTextComponent 

A 

- javax.swing.JTextArea 
- javax.swing.JTextField 


j avax. swi ng.J Fra me 


A 


javax.swing.JPasswordField 

—■ j avax. swi ng.J Label 
j avax. swi ng. J Li st 
javax.swing.JMenuBar 
- javax.swing.JPanel 

—■ j avax. swi ng.J Opti onPane 
javax. swing.JSlider 
— j avax. swi ng. BorderFactory 


Summary of Selected Classes and Interfaces 

In this section, we summarize a subset of standard classes and interfaces mentioned 
in the book. The classes and interfaces are listed in alphabetical order. For each 
class and interface we summarize, we include a brief description and some of its 
methods. The summary is intended as a quick reference. It is not a substitute for the 
A PI documentation. Fora complete list of methods and ful I descri ption, please con- 
sult the A PI documentation. 
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Class: j avax.swi ng. Abst ract Butt On 

Purpose: This is the base class of button and menu objects. Methods defined here are 

applicable to all subclasses. 

Hierarchy: j a va. I a ng, Obj ec t o— j a va, a wt. Co mponent o— 

java.awt.Container <]— j avax. swi ng.J Component o— 
j avax.swi ng. Abstract Button 

Subclasses: J Button, JCheckBox, J Radi oButton, JMenultem, J Me n u 

Public Methods: 

void ActionLi stener (Acti onLi stener listener) 

Adds listener as an action listener of this button. 

String get Text ( ) 

Returns the text of this button. 

void setText (string text) 

Sets the text of this button. 


Class:j ava. awt. event. Acti onEvent 

Purpose: An instance of this class represents an action event such as clicking a 

pushbutton or pressing the Enter key while the text field has a focus. 

Hierarchy: java,lang, Object o— j ava, ut i I . Event Obj ect o— 

j ava. awt . A WT Event o— j ava. awt. event . Act i onEvent 

Public Methods: 

String getActi o nCo mma nd ( ) 

Returns a string associated with the event source. 

Obj ect get Source! ) 

Returns the source object that generated an action event. 
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Interface: java, a wt. event. Acti onLi Stener 

Purpose: An instance of this class represents an action event such as clicking a pushbutton 

or pressing the Enter key while the text field has a focus. 

Hierarchy: java,util.EventListener <— j ava, a wt. event. Acti onLi stener 

Public Methods: 

void acti onPerformed(Acti onEvent event) 

This method is called when the event source generates an action event. A class that implements 
this interface must define the acti onPerf or me d method. 


Class: j avax. s wi ng. Bor der Fact ory 

Purpose: This factory class produces various types of borders for GUI components 

Hierarchy: j a v a, I a ng. Obj e c t o— j avax. s w i ng, Bor der Fact or y 

Public Methods: 

static Border createBeveI Border (i nt type, Color highlight, 

Col or shadow) 

Creates a beveled border object of a specified type and colors for highlighting and shadowing. 
The value fort y p e can be either Be v e I Border. L OWE RE D or Bevel Border. RAI SED. 

static Border createEtchedBorder (int type, Color highlight, 

Color shadow) 

Creates an etched border object of a specified type and colors for highlighting and shadowing. 
The value fort ype can be either Et c hedBor der. LOWERED orEtchedBorder. RAI SED. 

static Border createLi neBorder (Color color) 

Creates a line border object in a specified color and default line thickness. 

static Border createLi neBorder (Color color, int thickness) 

Creates a line border object in a specified color and line thickness. 
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Class:j ava.util, Date 

Purpose: This class represents a specific instance in time with millisecond precision. 

Hierarchy: java,lang.Object o— java.util.Date 

Constructors: 

Da t e ( ) 

Creates a new Date whose value is set to the time instance when it is created. 

Public Methods: 

boolean after (Date date) 

Returns true if this date is after the argument date, 

boolean before (Date date) 

Returns true if this date is before the argument d a t e . 

long getTime ( ) 

Returns the elapsed time in milliseconds since the epoch, which is designated as January 
1,1970,00:00:00 GMT. 


Class: j ava, text. Dec i maI For mat 

Purpose: This class is used to format decimal numbers. 

Hierarchy: java.lang, Object <|— j ava. text. Format o— 

java, text. Nu mb erFor mat o— j ava. text. Deci ma I For mat 

Constructors: 

DecimalFormat (String pattern) 

Creates a new Deci ma I F o r ma t initialized to a given pattern. 

Public Methods: 

String format (long number) 

String format (double number) 

Return the formatted string of a given n u mb e r. 
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Class: j a v a. i o. F i I e 

Purpose: An instance of this class represents a file or a directory. 

Hierarchy: j ava. I ang. Obj ect <|— java.io.File 

Public Constants: 

String pat hSepar at or 

This system-dependent path separator symbol is represented as a string. A path 
separator for Windows is the semicolon. This value can be retrieved by the statement 
System, get Property(" path, separator") also. 

String separator 

This system-dependent file separator symbol is represented as a string. A file separator 
for Windows is the backslash.This value can be retrieved by the statement System. 
getProperty("fi le,separator") also. 

Constructors: 

File (String filename) 

Creates a F i I e object for a given filename.The filename can be a full path name or a name 
relative to the current directory. 

Public Methods: 

String getAbsol utePath( ) 

Returns the full path name of this file, 

boolean isDirectory( ) 

Returns t rue if this F i I e object represents a directory, 
bool ean i sFi Ie( ) 

Returns t rue if this F i I e object represents a file. 

String!] Ii st( ) 

Returns an array of file and subdirectory names of this F i I e object representing a directory. 


Class: j ava. uti I . F o r ma 11 e r 

Purpose: This class is used to format the numerical and text output with justification and 

alignment. See Section 6.8 for sample usage. 

Hierarchy: j a v a. I a n g. Ob j e c t <| — j ava. uti I . Formatter 
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Class: java.util. For matter (Continued) 

Constructors: 

Formatter ( outputStream out ) 

Creates a Formatter for the specified output stream. Example: 

Formatter formatter = new Formatter(System. out) ; 

Public methods: 

Formatter format (String format, Object... expressions) 

Formats the given expressions using the formatting pattern format and outputs the result to 
the associated output stream. Expressions can be numerical, sttring,GregorianCalendar, and 
other types of data.The formatting pattern is explained in Section 6.8. 

Note: From Java 5.0 (SDK 1.5) System.out (PrintStream object) and String both support a new 
method named format that does the formatting. The format method of the String class is a 
class method that returns the formatted string. 


Class: j ava.awt. Graphi CS 

Purpose: This class supports drawing functionality. 

Hierarchy: j ava. I ang. Obj ect <]— j ava. awt. Graphi cs 

Public Methods: 

void drawLi ne( i nt xl, i n t yl, i nt x 2, i n t y 2) 

Draws a line between (x 1 , y 1) and (x 2 , y 2 ). 

void d r a wO v a I ( i n t x, i nt y, i nt width, i nt height) 

Draws an oval. 

void drawRect(int x, i nt y, i nt width, i nt height) 

Draws a rectangle. 

void d r a wRo u nd Re c t ( i n t x, i nt y, i nt width, i nt height, 
int arcWidth, int arcHeight) 

Draws a rectangle with rounded corners 
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Class: j ava. a wt . Graphi CS (Continued) 

void drawStri ngfStri ng text, i nt x, i nt y) 

Draws a given text at position ( x,y). 

void fi I I Oval (i nt x, i nt y, i nt width, i nt height) 

Draws a filled oval. 

void fi I I Rect(i nt x, i nt y, i nt width, i nt height) 

Draws a filled rectangle. 

void f i I I RoundRect ( i nt x, i nt y, i nt width, i nt height, 
int arcWidth, int arcHeight) 

Draws a filled rectangle with rounded corners. 

void set Col or ( Col or color) 

Sets the pen color to c 01 or. 

void setFontfFont font) 

Sets the font to f o n t . 


Class: j ava. u t i 1 

GregorianCalendar 

Purpose: 

This class represents a specific instance in time using the Gregorian calendar. 

Hierarchy: 

j ava 

. 1 a n g. Object <|— j ava. uti 1 . Cal endar o— 


j ava 

. util.Gregorian Calendar 

Public Constants: 

A partial list of constants defined in the Cal endar class. 


i nt 

DAY_OF_ MONTH 


i nt 

D A Y _ 0 F _ WE E K 


i nt 

3= 

1 — 

O 

1 

1 

sc: 

U_l 

LU 

3= 

i 

l_l_ 

O 

1 

<c 


i nt 

DAY_ of_ year 


i nt 

HOUR 


i nt 

HOUR_ OF _ DAY 


i nt 

Ml NUTE 


i nt 

SECOND 

See the C h 3 T e s t C a 1 e n d a r class for the sample uses of these constants. 
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Class: j ava. uti I . Gregori anCal endar (continued) 

Constructors: 

GregorianCal endar ( ) 

Creates a new Gregori anCal endar set to the time and date of the system clock when this 
object is created. 

Gregori anCal endar (int year, int mo nth, int day) 

Creates a new Gregori anCal endar set to the argument year, month, and day. Notice the 
month ranges from 0 to 11. 

GregorianCalendar (int year, int mo nth, int day, 

int hour, int minute) 

Creates a new Gr egori anCal endar set to the argument values. 

GregorianCalendar (int year, int mo nth, int day, 

int hour, int minute, int second) 

Creates a new Gregori anCal endar set to the argument values. 

Public Methods: 

int get (int field) 

Returns the specified field's value. See the class constants for the possible fields. 

Dat e get Ti me ( ) 

Returns this object represented as a Da t e . 
long getTime ( ) 

Returns the elapsed time in milliseconds since the epoch, which is designated as January 1,1970, 
00:00:00 GMT. 


Class: j avax.swi ng. J Component 

Purpose: This is the base class of all Swing GUI components such as buttons, text 

fields, menus, and others. Methods defined here are applicable to all 
subclasses. 

Hierarchy: java, lang, Object <|— j ava. awt . Component <d— 

j ava. awt. Contai ner o— javax.swing.JComponent 
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Class: j avax. swi ng.J Component (Continued) 

Public Methods: 

J Root Pane get Root Pane ( ) 

Returns the root pane that contains this component. 

void set Background (Color color) 

Sets the background of this component to c 0 I or. 

void setBorder (Border border) 

Sets the border of this component to b o r d e r . 

void setEnabl ed (boolean state) 

Enables this component if s t a t e is t r u e and disables it if s t a t e is f a I s e . 

void set Font (Font font) 

Sets the font used for this component to f o n t . 

void setForeground (Color color) 

Sets the foreground of this component to c 0 I or. This is how you change the text color of a 
component. 

void setVisible (boolean state) 

Makes this component visible if s t at e is t r u e and invisible if s t a t e isf a I s e . 


Class: javax.swing,] Fra me 

Purpose: This class is the extended version of j a v a. a wt, F r a me that works as a 

container for Swing GUI components. 

Hierarchy: j a v a, I a ng, Obj ec t o— j a v a, a wt. Co mpo ne nt <3— 

j ava. awt. Cont ai ner o— j ava, awt. Wi ndow o— 
j ava. awt. F r a me <l— j avax.swing,) Fra me 
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Class: j avax. s wi ng.j Fra me (Continued) 

Constructors: 

J F r a me ( ) 

Creates a new] F r a me initialized to default properties. 

JFrame (String title) 

Creates a new) F r a me with a specified title and default values for other properties. 

Public Methods: 

Cont ai ner get Cont ent Pane ( ) 

Returns the content pane of this frame, 
void resizable (boolean state) 

Enables the resizing of this frame if s t a t e is t r u e and disables the resizing if s t a t e isf a I s e . 
void setContentPane (Container pane) 

Sets the content pane of this frame. You can pass an instance of J P a n e I as an argument, 
void setj MenuBar (JMenuBar menubar) 

Sets the menu bar of this frame. 

void set Bounds ( i nt x, i nt y, i nt width, i nt height) 

Sets the origin point of this frame to (x,y), width to wi d t h ,and height to h e i g h t. 
void setLocation (int x, int y) 

Sets the origin point of this frame to (x,y). 
void setSize (int width, int height) 

Sets the width to wi d t h and height to h e i g h t . 
void setTitle (String title) 

Sets the title of this frame, 
void setVisible (boolean state) 

Makes this frame visible if s t a t e is t r u e and invisible if s t a t e is f a I s e . 
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Class: j avax.swing.J Label 

Purpose: An instance of this class is used to display uneditable text or image (or both). 

Hierarchy: java,lang.Object o— j a va, a wt. Component o— 

j ava. awt. Contai ner <|— j avax. swi ng. J Component o— 
j avax.swi ng.J Label 

Constructors: 

J La be I ( ) 

Creates a new j Label initialized to an empty image and text, 
j Label (Icon icon) 

Creates a new j Label with the specified image. Note that I con is an interface, and the 
I mage I con class implements this interface, so you can pass an I mage I con object as an 
argument. 

J Label (String text) 

Creates a new J Label with the specified text. 

Public Methods: 

Icon get I con ( ) 

Returns the icon of this label. 

String getText ( ) 

Returns the text of this label, 

void set I con (Icon icon) 

Sets the icon of this label, 

void setText (String text) 

Sets the text of this label. The argument should be a single line of text. Any text after the 
new-line character is ignored. 


Class: j avax. s wi ng. 

J Li st 


Purpose: 

This component represents a list box. 


Hierarchy: 

j a v a. 1 a ng, Obj e c t o— java.awt 
j a v a. a wt. Co nt a i ne r <|— j avax. 
j avax. swi ng.J Li st 

. Component o— 

swi ng, j Component o— 
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Class: j avax. swi ng.J Li St (Continued) 

Constructors: 

J Li st (Object[] list) 

Creates a new j List with its items set to the passed array elements. 

Public Methods: 

i nt getSel ectedl ndex ( ) 

Returns the index of the first selected items. If no item is selected, then -1 is returned. 

i nt[] getSel ectedl ndi ces ( ) 

Returns an array of indices of all selected items. 

void setSel ecti onMode ( i nt mode) 

Sets the selection modeofthislisttomo d e . The three possible values for mode are L i s t - 
Sel ecti onModel . SI NGLE SELECTION, Li stSel ecti onModel . SI NGLE I NTERVAL 
SELECTION,and Li stSel ecti onModel . MULTI PLE I NTERVAL SELECTION.The 
default mode isLi stSel ecti onModel . MULTI PLE INTERVAL SEL ECTI ON. 


Class: j avax.swing, JOptionPane 

Purpose: 

This is a convenience class that supports a quick and easy way to deal with a 
standard dialog box for displaying short messages or getting an input value. 

Hierarchy: 

ava, 1 ang. Obj ect o— j ava, awt. Component o— 


a va, a wt. Co n t a i n e r o — j avax. swi ng.J Component < 3 — 


avax. swi ng,j Opti onPane 

Public Constants: 

This is a partial list, 
nt YES_OPTION 
nt N0_OPT 1 ON 
nt CANCEL_OPT1 ON 
nt 0K_OPT 1 ON 
nt YES_NO_CANCEL_OPTI ON 

Public Methods: 

Note the listed methods are all class methods. 

static i nt showConf i rmDi al og (Component parent, Object message) 

Displays a standard confirmation dialog and returns the value to indicate which button (Yes, 

No, or Cancel )is clicked. 
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Class: javax. swing. JOptionPane (Continued) 

static i nt showConf i r mD i a I o g (Component parent, Object message, 

String title, int optionType) 

Displays a confirmation dialog with me s s a g e as its prompt and t i t I e as the dialog title. The 
valueofopti onType determines which buttons are shown in the dialog. 

static String showInputDialog (Component parent, Object message) 

Displays a standard input dialog and returns the entered value as a S t r i n g . 

static void showMessageDi al og (Component parent, Object message) 

Displays a standard message dialog with the text me S s a g e . 


Class: j avax.swing.j Slider 

Purpose: This component represents a slider. 

Hierarchy: j a va. I a ng, Obj ec t o— j a va. a wt. Co mponent o— 

j a va. a wt. Co n t a i ne r o— j a v a x. s wi ng, J Co mp o n e n t o— 
j avax. swi ng.J SI i der 

Constructors: 

j SIi der ( ) 

Creates a new horizontal slider ranging from 0 to 10 0 .The initial position of the slider knob is set 
to 5 0. 

JSlider (int min, int max) 

Creates a new horizontal slider ranging from mi n to ma x . The initial position of the slider knob is 
set to the average of mi n and max. 

JSlider (int orientation, int min, int max, int value) 

Creates a new slider ranging in values from mi n to ma x . The initial position of the slider knob is 
set to v a I u e , and the orientation to orientation (JSlider.^VERTICAL or 
JSlider. HORI ZONTAL). 

Public Methods: 

i nt getVal ue ( ) 

Returns the current value of this slider. 
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Class: j avax. swi ng.J TextComponent 

Purpose: An instance of this class is used to display uneditable text or image (or both). 

Hierarchy: java.lang, Object < 3 — j ava. awt. Component <— 

j ava. awt. Contai ner <|— j avax. swi ng.J Component <— 
j avax. swing,) Text Co mponent 

Constructors: They use the constructors of the subclasses j T e x t Ar e a and) Text Fi el d. 

Public Methods: 

String get Sel ect edText ( ) 

Returns the selected text of this text component. 

String get Text ( ) 

Returns the text of this text component. 
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Class: j avax.swi ng.J TextComponent (Continued) 
void setEdi tabl e (boolean state) 

Makes this text component editable if s t a t e is t rue and an editable if s t a t e isf a I s e. 
void setText (String str) 

Sets the text of this text component to a specified str. 

class:j ava. I ang, Math 

Purpose: This class supports mathematical functions. 

Hierarchy: java.lang. Object <|— java.awt.Graphics 

Public Constants: 

double PI 

The value of pi. 
doubl e E 

The value of natural number e. 

Public Methods: Please refer to Table 3.6 for a list of methods. 


Class:j ava. uti I . Random 

Purpose: An object to generate random numbers. 

Hierarchy: j a va. I a n g . Ob j e c t <| — j ava. uti I . Random 

Constructors: 

Random ( ) 

Creates a new random number generator. 

Public methods: 

i nt next I nt ( ) 

Returns a pseudorandom int value, 
i nt next I nt ( i nt N) 

Returns a pseudorandom int value between 0 (inclusive) and N (exclusive). 
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Class:j ava. uti I . Scanner 

Purpose: An object to input data from an input stream. 

Hierarchy: j a v a. I a ng, Obj ec t < 1 — j ava. uti I . Scanner 

Constructors: 

Scanner ( InputStream source ) 

Creates a new Scanner with input values coming from the source. 

Example: Scanner scanner = new Scanner! System. in); 

Public methods: 

byt e next Byt e( ) 

Returns the next input value as a byte. 

double next Doubl e( ) 

Returns the next input value as a double, 
float next FI oat( ) 

Returns the next input value as a float, 
int next I nt( ) 

Returns the next input value as a int. 

I ong next Long) ) 

Returns the next input value as a long, 
short next Short( ) 

Returns the next input value as a short. 

String next ( ) 

Returns the next input value as a String, 
void useDel i meter(Stri ng marker) 

Sets marker as a marker to separate the input values. Useful when reading a text that contains 
spaces. Example:To set the tab as the separator, write 
scanner. useDeli met er("\t") ; 
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Class: j ava. text .Si mpl e D a t eFor mat 

Purpose: This class is used to format dates. 

Hierarchy: java. I ang. Object <|— j ava. text. Format o— 

j ava. text. Dat eFor mat <— java. text. Si mpl eDateFor mat 

Constructors: 

S i mp I e Da t e F o r ma t ( ) 

Creates a new Si mpl eDateFor mat initialized to a default format. 

Si mpl eDateFor mat (String format) 

Creates a new S i mpl eDateFor mat initialized to the specified format. See Table 2.1 for the 
symbols you can use to specify the format. 

Public Methods: 

String for mat (Date date) 

Returns the formatted string of a given date. 


Class: j ava.lang. String 

Purpose: This class represents an immutable sequence of characters. 

Hierarchy: j ava. I ang. Obj ect o— j ava. I ang. Stri ng 

Constructors: 

String ( ) 

Creates a new empty Stri n g. 

String (String str) 

Creates a new Stri n g from a given str. 

Public Methods: 

char chat At (int index) 

Returns a character at position i n d e x . The first character in a string is at position 0. 
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Class: j ava. I a n g. Stri ng (Continued) 

String concat(St ri ng st r) 

Returns a new string that is a concatenation of this string and the arguments t r .The 
concatenation operator + is equivalent to this method. 

boolean equal s(Stri ng str) 

Returnst r ue if this string has the same sequence of characters as the arguments t r. 
Comparison is done in a case-sensitive manner. 

boolean equal si gnoreCase(Stri ng str) 

Is the same as e q u a I S but in a case-insensitive manner. 

static String format(String format, Object... expressions) 

Formats the given expressi ons following the formatting pattern f o r ma t and returns the 
formatted string. 

i nt length!) 

Returns the number of characters in this string, 

boolean matchesfString regex) 

Returns true if this string matches the given regular expression regex. 

String substri ng(i nt start) 

Returns a substring of this string from index position start to the last character of this string. 

String substri ng(i nt start, i nt end) 

Returns a substring of this string from index position start to end-1. 

String toLowerCasef ) 

Converts this string to all lowercase characters. 

String t o Up pe r Cas e( ) 

Converts this string to all uppercase characters. 

String trim! ) 

Removes the leading and trailing whitespaces (e.g., blank spaces, tabs, new lines). 
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Class: j ava. I ang.Stri ngBuffer 

Purpose: This class represents a mutable sequence of characters. 

Hierarchy: j a v a. I a ng. Obj e c t <|— j ava. I ang. Stri ngBuffer 

Constructors: 

Stri ngBuffer ( ) 

Creates a new empty Stri ngBuffer with the initial capacity of 16 characters. 

Stri ngBuffer (String str) 

Creates a new Stri ngBuffer whose content is initialized to a given str. 

Public Methods: 

Stri ngBuffer append (char c h) 

Stri ngBuffer append (String str) 

Appends an argument to this string buffer. 

char charAt(int index) 

Returns a character at position i n d e x . The first character in a string is at position 0 . 

Stri ngBuffer deI eteCharAt(i nt index) 

Removes the character at position index from this string buffer. 

Stri ngBuffer insert (i nt index, char ch) 

Stri ngBuffer insert (i nt index, String str) 

Inserts an argument to this string buffer at position i n d e x . 

i nt length!) 

Returns the number of characters in this string. 

StringBuffer reverse! ) 

Reverses this string buffer. 

String substri ng(i nt start) 

Returns a substring of this string buffer from index position Start to the last character of this 
string. 

String substri ng(i nt start, i nt end) 

Returns a substring of this string bufferfrom index position start to end- 1. 
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Appendix D 

UML Diagrams 


What is UML? 

The unified modeling language (UML) provides graphical notation to model 
computer systems that are developed by using object-oriented software engineer¬ 
ing (OOSE). The focus of OOSE is identifying the problem elements that produce 
or consume information and describing the relationships among these elements. 
In OOSE, objects are defined to represent these elements during the system analy¬ 
sis and design process. UML diagrams allow software engineers to indicate the 
relationships among the objects used to define the system. M ost of these objects 
will need to be implemented using software in the final system. U M L is particu¬ 
larly useful when the plan is to implement the system in an object-oriented lan¬ 
guage like Java. 

Software engineers use several types of models during the analysis and design 
phases of the software development process. Data models describe object attributes 
and relationships with each other. Functional models show how data is transformed 
as it flows through the system. Behavioral models depict the actions taken by the 
system in response to events. Architectural diagrams show the relationships among 
the hardware and software components needed to implement the complete system. 
UML provides several types of diagrams to support the modeling needs of software 
engineers. We use a subset of the UM L class diagram notation to describe the de¬ 
sign of sample programs in this textbook. 

In this appendix, we will describe and illustrate the use of U M L diagrams by 
model i ng the attri butes, behavior, and architecture of a si mple vendi ng machi ne. This 
vending machine accepts a single coin and dispenses a single product. The machine 
does not give change. If a bad coin is inserted, or if the machine has no product to dis¬ 
pense, the coin will be returned to the customer. A merchant owns the machine and 
adds products to it. The merchant also removes the coins from the coin box. 


Class Diagram 

Class diagrams are one of the most important UML diagrams used by software en¬ 
gineers. Class diagrams are used to create logical models of computer-based sys¬ 
tems. A class diagram shows class structure, contents, and the static relationships 
among the classes used to model a system. These relationships are known as asso¬ 
ciations and are drawn as lines connecting the related graph nodes. Each node in a 
class diagram is labeled with its class name. The class node may also contain lists 

955 


www.it-ebooks.info 


956 Appendix D UML Diagrams 



Figure 1 Class diagram. 


of data attributes and method prototypes. The visibility of attributes or methods can 
be indicated by prefixing their names with a + (public) or - (private). 

An association line indicates that there is a linkage between two classes. 
Some associations may be labeled with a string indicating the type of relationship 
between the classes. Each end of the association is labeled with a number, *, or 
range to describe the multiplicity of the link (e.g., 1. .* designates a multiplicity that 
ranges from 1 to many). Part-whole relationships (known as aggregations in UML) 
are indicated using an open diamond at one end of the link. Inheritance relation¬ 
ships (known as generalizations in U M L) are indicated using an open triangle to 
point to the appropriate super class. Class instances are shown drawing an arrow¬ 
head poi nti ng to a cl ass i nstance node. 


Use Case Diagram 

Use case diagrams are used to model system functional requirements. These dia¬ 
grams show how users interact with the system. They are drawn to be independent 
of the specific user interface design thatwill be used in the final system. Use cases 
summarize several scenarios for a user task or goal. A scenario is an instance of an 
instance of use case for a particular actor, at a specific time, with specific data. 
Each scenario would be described using text description and shown graphically 
with a sequence diagram. Use case diagrams assist software engineers to develop 
test cases. 

Users are called actors and are represented in use case diagrams by labeled 
stick figures. Use case nodes are labeled with user goals or tasks. Actors are con¬ 
nected to the appropriate nodes using lines. Links may be labeled with the string 
«extends» to show explicitly optional actor interactions or handling of exceptional 
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Figure 2 Use case diagram. 


uses. The string «uses» may be used to label links to existing use cases being used 
as subsystems in the current use case. Each path through a use case diagram repre¬ 
sents a separate use case. 


Sequence Diagram 

Sequence diagrams model system behavior for use cases by showing the necessary 
class interactions. Sequence diagrams depict workflow from a use case graphically. 
They show the temporal sequence of message exchanges among a collection of 
objects as they communicate to achieve a specific task, In particular they show how 
the user (actor) interacts with a system to get work done (i.e., what messages get 
sent and when are they sent). The events modeled in sequence diagrams are exter¬ 
nal events initiated by an actor. 

The actors and objects are arranged horizontally across the top of the dia¬ 
gram. The vertical dimension represents time. A vertical line called a lifeline is 
attached to each actor or object. The lifeline becomes an activation box to show the 
live activation period of the object or actor. A message is represented using an 
arrow labeled with a message. The message label may contain an argument list and 
a return type. Dashed arrows may be used to indicate object flow. If an object's 
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Customer 

I 

I 

I 


Coin Box 


Dispenser 


insertCoin () 


rejectCoin () 



requestProduct () 



rejectRequest () 




i 


Product 


Figure 3 Sequence diagram. 


life ends during the execution of the use case an X is placed at the bottom of its 
lifeline. 


Collaboration Diagram 

Collaboration diagrams show the message passing structure of the system. The 
focus is on the roles of the objects as they interact to realize a system function. They 
can be used to represent portions of a design pattern and are useful for validating 
class diagrams. 

A collaboration diagram is a directed graph with the objects and actors as ver¬ 
tices. Directional links are used to indicate communication between objects. These 



Customer 


1. sendCoin 


2. requestProduct 



4. returnCoin 


3. rejectRequest 


Figure 4 Return coin collaboration diagram. 
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Figure 5 Product delivery collaboration diagram. 


links are labeled using appropriate messages. Each message is prefixed with a 
sequence number to indicate the time ordering required to complete the system 
function. As you can seein F i g u re 5, not every collaboration diagram can be drawn 
horizontally or vertically. 


State Diagram 

State diagrams describe the behavior of a system, subsystem, or an individual object. 
The system state is determined by the values assigned to object attributes. A system 
is assumed to remain in its current state until some new event occurs. State dia¬ 
grams show changes in system state or object attributes in response to external 



Figure 6 State diagram. 
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events or triggers. They can display the sequence of states an object goes through i n 
response to potential triggers. 

A state diagram is a directed graph whose nodes are labeled with state names. 
The nodes in a state diagram are drawn as rectangles with rounded corners. The 
links between the nodes are called transitions and are labeled with the name of the 
triggering event. A small black circle is used to represent the start state. A small 
black circle with a ring around it is used to represent the end state. Enclosing a 
group of nodes in the state diagram with a rectangle having rounded corners can be 
done to identify a substate. 


Activity Diagram 

Activity diagrams show the workflow that an object or system component performs. 
They can show both data flow (information exchange) and control flow (operation 
ordering). Activities are states representing the execution of a set of operations or 
thread needed to realize a system function. The transitions to new activities are 
triggered by the completion of the current activity. Activity diagrams are similar to 



Figure 7 Activity diagram. 
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state diagrams except that transitions are triggered by internal events. Internal 
events are not visible to the system user. Activity diagrams can be used to visualize 
the interrelations and interactions between different use cases. Activity diagrams 
are usually associated with several classes. 

Object responsibilities can be shown in an activity diagram by drawing swim 
lanes labeled with object names. Activity nodes are drawn using rectangles having 
semicircles on each end. The start and end state symbols are the same as those used 
in state diagrams. Links may be labeled with conditions that are the result of com¬ 
pleting an activity. Decision points may be represented using unlabeled diamonds. 
Activity diagrams can be used to show concurrent operations like fork, join, and 
rendezvous. 


Component Diagram 

Component diagrams show the relationships (i.e. dependencies, communication, lo¬ 
cation, and interfaces) among the software building blocks or components in a sys¬ 
tem. The component diagram might be described as a physical analog of the system 
class diagram. It is typically made up of several classes and shows the high level 
code structure of the system. 

Each system component is represented as a rectangle with tabs. A component 
interface is represented using a small round circle connected to a component by a 
line. An interface describes a group of operations used or created by a component. 
Arrows can be used to show the direction of information flow. Dashed lines can be 
used to indicate dependencies among components. 



Coin Box 



Dispenser 


Figure 8 Component diagram. 


Deployment Diagram 

Deployment diagrams depict the physical resources for a system including nodes, 
components, and connections. Deployment diagrams show the relationships 
among both hardware and software components. They can also show the con¬ 
figuration or deployment of run-time elements, software components, processes, 
and objects. Often component diagrams are combined in a single system deploy¬ 
ment diagram. 
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Figure 9 Deployment diagram. 


Nodes in a deployment diagram are typically capable of executing code 
components and are represented by 3D drawings of boxes. Associations between 
two nodes are drawn as lines to represent physical connections (e.g., Ethernet) 
between the nodes. 
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Curly braces. See Braces ({}) 
CurrencyConverter class, 631 
Current directory, 686-687 
Cycles, 8 

D 

Dangling else problem, 226, 237-238 
Data buffers, 6 
Data caching, 696 
Data members, 21 
Data types, 100-101, 254 
arithmetic expressions of, 254 
numerical, 85-150 
primitive vs. reference, 92 
Data values 
arrays of, 557 

graphical representations for, 22 
saving, 702-703 
DatalnputStream objects, 704 
DataOutputStream objects, 700-702 
Date class, 60-63,120, 342, 681, 939 
Date objects, 82-83,122,342,435 
Deallocation, 37 
of memory, 577 
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Debugging, 25 
Decimal number system, 5-6 
Decimal-to-binary conversion, 6-7 
DecimalFormat class, 86, 104, 213, 335-336, 

423, 939 

DecimalFormat objects, 104,134, 184 
Declaration of Independence, online story about, 124 
Declarations, 46-47 
invalid, 93 

Decrement operators, 235 
Decryption, 553 

deduct method, 162,164-165,195 
tests within, 238 
default (reserved word), 253 
default case, 288 

Default constructors, 176-177, 463 
added by compiler, 750-752 
Default delimiter, 108 
Defensive programming, 256 
Delegation-based event model, 802 
delete method, 621-625 
Deletion operation, for arrays, 575-576 
Delimiters (delimiter characters), 772 
resetting, 65 
DeM organ's law, 241 

truth table illustrating, 241 
Denominator, 409-410 
Dependency relationships, 32 
Deployment diagrams, 961-962 
Depth, of a heap, 658-659 
Derived class, 23, 735 
Descendants, 23 

describeProgram method, 200-202, 212-215, 341 
describeR ules method, 353, 361 
Design alternatives, 71-72, 613 
Design phase, 25 
Destinations, of outputs, 695 
Development 
bottom-up, 200 
incremental, 86, 275 
software, 15-28 

steps in, 71, 126-128, 200, 275, 352, 421, 535, 
610, 717, 763 
top-down, 199 
Diagrams, program, 41 
Die class, 186-188, 195-196 


Difference Engine, 2 
Digital video cameras, 8 
Dimension objects, 278 
dimension variable, 283 
Directories, current, 686-687 
Directory listing, of algorithms, 883-885 
directory!.isting method, 883-885 
Disk drives, 8-9 
Display monograms, 73-76 
displayOutput method, 209-210 
Divide-by-zero error, 242 
Division operators, 94 
DNA sequences, 529-532, 629 
DNA transcription, 531 
do-while loops, 326, 353 
do-while statements, 319-323 
controlling flow of, 320 
correspondence to general format, 320 
syntax for, 319 
writing, 363 

Documentation, program, 41 
Door class, 477, 480 
Door objects, 480-481 
Dorm class, 477-480, 482, 485, 714-716 
Dorm objects, 477, 479, 488, 714 
Dot notation, 44,193,195, 385, 392 
Double ampersand (&&), 239, 242, 511 
double data type, 87-93, 94, 97, 100-101, 165 
arrays of, 557-559, 583, 627 
double literal constants, 100 
Double minus operator (—), 235 
Double plus operator (++), 235 
Double slashes (//), 40 
double values, 100-101,167 
Double vertical bar (||), 239, 242 
draw method, 260-261, 281, 283 
DrawableShape class, 272, 274, 277-280, 283-288, 
290-293 

D rawableShape objects, 276 
Drawing graphics, 256-266 
java.awt.Color, 260-263 
java.awt.Dimension, 263-266 
java.awt.Graphics, 257-260 
java.awt.Point, 263 

drawing methods, defined for Graphics class, 
259-260 
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Drawing shapes program, 272-293 
DrawingBoard class, 259, 272-277, 281-282 
DrawingBoard objects, 276-277, 279 
DrawingBoard window, 277 
drawLine method, 836 
drawOval method, 836 
drawRect method, 258 

DrawShape class, 274, 276-277, 284, 288-293 
drawShape method, 283 
Drive-through ordering system, 302 
Drop-down lists, 848 
Duplicate code, avoiding, 196 
Duplicate tests, eliminating, 322 

E 

Echo printing, 64, 72, 128 
Eckert, J. Presper, 3 
Edit-compile-run cycle, 49-52 
Eggy-Peggy (word game) program, 550, 552 
Element class, 178-185 
Elements. See also Array elements 
else (reserved word), 227 
Else blocks, 224-228 
rules for writing, 228 
Empty strings, 548 
Encapsulation mechanism, 180-181 
Encryption, 553 
End cases, 348, 623 
end method, 520 
endldx, 507, 509 
Engineering, software, 24-26 
Enhanced editor approach, 908-909 
Enhanced for loop, 577 

ENIAC I (Electronic Numerical IntegratorAnd 
Calculator), 3 
enlarge method, 614 
EntranceM onitor program, 481-482 
entry array, 668 
entrySet method, 606 
enum (reserved word), 267 
Enumerated constants, 266-271 
Environment, setting for Java programs, 
906-907 

Equal symbol (==), 251 

Equality testing, 248, 507, 521-522 

equals method, 248-250, 507, 521-522 


equalsIgnoreCase method, 248, 507 
Equivalence test, 521-522 
Error class, 451 

Error messages, 50-51, 255, 320 
Errors. See also Exceptions 
common in programming, 246 
compilation, 51,101 
divide-by-zero, 242 
execution, 52 
identifying, 77-78 
off-by-one, 315-316 
overflow, 314 
Escape character, 66, 687 
Estimation, of execution time, 342-346 
Euclidean algorithm, 311, 345 
Event-driven programming, GUI objects and, 
787-880 

key concepts, 871 

Event listener objects, 802, 806-808 
Event model, delegation-based, 802 
Event sources, 802 
Events 
action, 802 
handling, 802 

Exception catcher methods, 458-460 
Exception class, 451, 454, 469, 471 
Exception propagator methods, 458-460 
Exception-throwing methods, 458, 510-511 
Exceptions, 445-494 
catching, 446-453 
checked, 466 
defined, 446 

differentiating from assertions, 475-476 
key concepts, 492 
out-of-bound, 505 
programmer-defined, 469-471 
propagating, 458-466 
runtime, 466 
thrown, 453-458 
unchecked, 466 
Excess format, 139 
Exchange rate, computing, 631 
Exclamation point (!), 239 
Execution errors, 52 
Execution time, estimating, 342-346 
expand method, 616 
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ExpandableArray class, 597 

Explicit calls, to constructor of superclasses, 752 

Explicit casting conversions, 96-97 

Exponential notation, 101 

Exponents, computing, 296 

Expressions 

arithmetic, 94-99 
Boolean, 239-247 
indexed, 558 
invalid, 141 
regular, 510-517 

extends (reserved word), 735, 739, 795 
extends clause, 749 
Extensions, possible, 293 
extract method, 655-657 
Extraction phase, of heapsort, 648, 658 

F 

Factorials, computing, 347-349, 882-883 
Faculty class, 270-271 
false (logical value), 93 
false (reserved word), 38 
Fermi (game), 443-444, 879 
Fibonacci numbers, 145, 367, 895-896 
Fields, 335 
File access, 686 
File class, 940 
File filters, 693 
File I/O, 685-732 
high-level, 700-709 
low-level, 695-699 
File objects, 686-695, 761, 883-885 
FilelnputStream objects, 697-699, 704, 711 
FileM anager class, 533-534, 538-540 
FileM anager objects, 540, 707 
FileNotFoundException, 539, 706-707 
FileOutputStream objects, 695-697, 

702-703 

FileReader objects, 704, 761 
Files 

closing, 696 
opening, 688 
fill method, 260-261 
finally (reserved word), 456 
finally blocks, 456-457 
find method, 519 


findlndex method, 621-622 
First generation computers, 3 
Fixed-pitch fonts, 809 
Fixed-size array declarations, 565 
Flags, 243 
boolean, 243 
longM essageFormat, 243 
float data type, 87-93, 94, 97, 100-101 
Floating-pointformat, 136,138 
Floppy disks, 8-9 
FlowLayout, 800, 820-821 
Fonts, 809 

for-each loops, 330, 577-582,600 
nesting, 596 

for loops, 330, 561-563, 577-578, 766, 884, 
886-887 

for statements, 327-331. See also Nested-for 
statements 

controlling flow of, 327 
correspondence to general format, 327 
inner, 333 
outer, 333 

Force between two bodies, computing, 

145-146 

Formal parameters, 167 
Format class, 768, 770 

format method, 338. See also javabook.Format 
Formats. See ASCII; Binary number system 
Formatter class, 335-339, 940-941 
FORTRAN (programming language), 11 
Forward slash (/), 687 
Fourth generation computers, 3 
Fraction class, 249-250, 374, 378, 386-387, 393, 
402-405, 439, 441, 460 
complete, 408-418 

Fraction objects, 375-376, 378, 380-381, 383-384, 
389, 392 
Fractions 

normalized, 139 
unnormalized, 139 

Frame windows, customizing, 790, 793-799 
F rames 

content pane of, 257-258 
making the event listener, 806-808 
French, 498 
friends list, 600-602 
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Fully qualified names, 44 
Functions. See M ath classes 

G 

gamePanel objects, 831 
Games. See Eggy-Peggy; Fermi; HiLo (game) 
program; playGame method 
Garbage collection, 37, 577 
gcd. See Greatest common divisor 
General-purpose frames, 790 
generate!. oanTable method, 341 
generateSecretN umber method, 353-360 
Geometric functions. See M ath classes 
German, 498 

get methods, 158, 435, 600, 606, 629 

getA bsolutePath method, 691, 884 

getActionCommand method, 804, 858 

getAge method, 449, 451, 460-462, 469-470 

getBookList method, 420 

getBounds method, 866 

getCenterPoint method, 278 

getCharge method, 427 

getComparator method, 674 

getConcordance method, 543 

getContentPane method, 797-798 

getDimension method, 278 

getF irstPerson method, 724 

getl nitialB alance method, 162,164 

getl nput method, 200-202, 204, 487, 493 

getKey method, 606 

getList method, 427, 443 

getL oanA mount method, 341 

getLoanPeriod method, 205 

getM aximumSpeed method, 19-20 

getM essage method, 452 

getM onthlyPayment method, 209-211 

getName method, 487 

getNextGuess method, 356-359 

getNextPerson method, 724 

getObstacleDistance method, 19 

getOwnerName, 157-152 

getOwnerName method, 156,159,170 

getPeriod method, 205 

getProperty method, 816 

getRootPane method, 804 

getSelectedl ndices method, 848, 851 


gets elected I tern method, 848 
getSelectedValues method, 851 
getShape method, 289 
getSource method, 804 
getTime method, 122, 342, 435 
getTotalPayment method, 209-211 
getValue method, 606 
Gigahertz (GHz), 8 
Google search engine, 533 
Gosling, James, 12 

GraduateStudent class, 738-743, 752-761, 

770-774 
Granularity, 346 

Graphical representations, for data values, 22 
Graphical user interface. See GUI objects 
GraphicLotteryCard class, 265-266 
Graphics, drawing, 256-266 
Graphics class, 259-260,941-942 
drawing methods defined for, 259-260 
Graphics context, drawing a text in, 293 
Graphics objects, 257 

Gravitational constant, computing, 145-146, 
328-330, 370-379 
Greatest common divisor (gcd) 
computing, 899 
finding, 310-313 
methods, 342-343, 375-376, 392 
Gregorian calendar system, 124 
GregorianCalendar class, 83, 86,120-124, 435, 
942-943 

GregorianCalendar objects, 120,122-124,145, 272, 
430, 434 

GridLayout objects, 825-826 
GUI (graphical user interface) objects, 787-880 
components of, 839-856 
key concepts, 871 

GUI programming, basics, 799-808 

H 

Hard disks, 8-9 
HashMap class, 605,714,759 
hasNext method, 600 
Header comments, 42 
Heap class, 646-647,658-659,682 
constraints on, 647, 659 
depth of, 658-659 
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Heap class— Cont. 
modifying, 682 
root of, 646 

Heap structure, 648, 651 
Heaps, 646 
Heapsort, 646-659 

performance of, 657-659 
rebuild step, 648-650 
Heapsort algorithm, 648, 651 
Heavyweight classes, 789 
Helper classes, 604 
Hertz, 8 

Heterogeneous lists, 599 

Hiding information, 180 

Hierarchies, of inheritance, 24 

High-level code, 11 

High-level files, 700-709 

High-level programming languages, 11-12,14 

HiLo class, 352-355,360-361,366 

HiLo (game) program, 351-361 

HiLoDisplay, 833 

Homogeneous lists, 599 

Human Genome Project, 529 

I 

I/O. See Input/output devices 
IBM,3 

IDE. See Integrated development environment 
Identifiers, 33 

invalid, 38-39, 78-79 

IEEE (Institute of Electronics and Electrical 
Engineers) Standard, 138 
if statements, 222-232, 296. See also Nested-if 
statements 

controlling flow of, 224, 228-229 
formatting styles for, 226-228 
invalid, 232 
rewriting, 296 
syntax for, 231, 233 
if tests, 234 

if-then-else statements, 246, 779 
syntax for, 223 

if-then statements, syntax for, 223, 228 
IllegalArgumentException class, 460, 

463, 611 

Imagelcon objects, 813 


Implementation classes, enforcing consistency 
among, 660 

implements Serializable (phrase), 479, 710, 716 
Implicit casting conversions, 96-97 
Import statements, 43-46, 78 
I mprecise loop counters, 314 
I ncrement operators, 235 
Incremental development, 69, 86, 275 
Indentation, 235-237 
styles of, 236-237 

IndependenceDay program, 123,124 
Indexed expressions, 558 
indexOf method, 58, 73-74 
IndexOutOfBoundsException error, 600 
Infinite loops, 313-318 
Information hiding, 180 
Inheritance, 23-24 

and constructors, 749-752 
defined classes with, 737-741 
guidelines for using, 749-752, 758-759 
hierarchies of, 24 

and member accessibility, 744-749 
and polymorphism, 733-785 
Initialization, 88-93 
of class variables, 663 
Initials, program for printing, 69-75 
Input buffers, 108 
Input files, 685-732 

Input/output (I/O) devices, 4-5, 8. See also File I/O; 

Object I/O 
Inputvalues 

accepting, 127-129, 204-208 
code, 206-208 
getting numerical, 107-112 
inputBooks method, 429 
inputColor method, 288-289 
inputFile method, 540 
InputHandler class, 482, 486-487, 493 
InputHandler object, 488, 490 
inputLine text field, 812 
InputM ismatchException class, 447, 451, 460 
Inputs, 86 
souces of, 697 

inputShapeType method, 288, 307 
InputStream class, 63 
Insertion sort, 680-681 
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InstallingJava programs, 903-904 
Instance constants, 23 
I nstance data val ues, 20- 23 
Instance methods, 18, 393, 405 
declaring private, 182 
Instance variables, 23, 615 
declaring private, 182 
instanceof operator, 810 
Instances, of classes, 17 
I nstantiable classes, 621, 754 

loan calculator program with, 198-213 
Institute of Electronics and Electrical Engineers. 
See IEEE 

int data type, 87-93, 97,252,254 
Integer division, 94 
I nteger division operators, 94 
Integer indices, 605 
Integer objects, 603 
I nteger.parsel nt method, 430 
Integers, 86-92 

computing the greatest common divisor, 899 
data types for, 87-93 
initializing, 88-93 
representation of, 136 
sorting, 638-639, 680 
Integrated circuits, 3 
large-scale, 3 

Integrated development environment (IDE), 

903, 909 

Integration testing, 25 
Intel processors, 8-9 
Interest rates, computing, 147 
Interface objects. See GUI objects 
I nterfaces 

guidelines for using, 598, 758-759 
implementation of, 660 
listed alphabetically, 933-934 
listed logically, 934-935 
summary of selected, 936-954 
user-friendly, 319 
I nternet, 4 

Java language for, 498 
Interpreters, 51 
intList, 603 
intValue method, 603 
lOException class, 538-539 


lOException objects, 706-707, 712, 719 

IS-A relationship, 758 

isFile method, 688 

isM etaDown method, 866 

isM oving method, 244 

isRadiusValid method, 231 

isSelected method, 840 

isSorted method, 641 

isUpperCase method, 549 

isValidHeap method, 655 

itemStateC hanged method, 842, 847 

Iteration, 600 

iterator method, 600 

J 

J apanese, 498 

Java 2 SDK (Software Development Kit), versions, 
473, 524, 603, 705, 709, 797, 903-904 
J ava A PI reference manuals, 52, 62, 256, 606, 

629, 773 

Java applets. See Applets 
Java applications, 12, 30-52, 78 
J ava classes, standard, 32, 52-68 
Java Collection Framework (JCF), 597, 600, 606, 
608, 610, 629 
Java compilers, 236-237 
Java interpreters, 51 

J ava language, 498. See also M ath classes; 
Programs 

coding standards, 227 
development tools, 49-52 
exponential notation in, 101 
introduction to, 12 
key concepts, 76 
programming basics, 29-80 
translating pseudocode into, 340-342 
Java Language Specification, 227 
Java naming conventions, 34, 46, 76, 78-79 
J ava N ati ve I nterface (J NI), 477 
J ava packages. See also javabook package 
java.awt, 256-266, 788 
java.awt.Color class, 260-263, 276 
java.awt.Dimension class, 263-266 
java.awt.Graphics class, 257-260 
java.awt.Point class, 263 
java.sql, 83 
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Java packages— Cont. 
java.text, 61 

java.util, 60, 83,120, 597, 672, 677, 682, 772 
java.uti I .regex, 517 

javax.swing, 44-45, 689, 693, 771, 790, 800, 816 
J ava programs. See also Sample programs 
compiling the program, 907 
creating a program, 904 
how to run, 903-910 
installing, 903-904 

opening a command prompt window, 905-906 
running the program, 907 
saving the program, 904-905 
setting the environment, 906-907 
Java standard classes, 32, 52-68 
J ava stream objects. See Stream objects 
Java Virtual M achines (J VM ), 52 
javabook package, 45-46, 768 
importing, 45-46 
javabook.Format, 306 
javadoc comments, 41-42, 444 

using for class documentation, 405-408 
javadoc files, 407 
javadoc tags, 404 
JavaFilter class, 693-694 
J avaPrograms directory, 686 
J avaPrograms folder, 402-403 
J Button class, 788-790, 804, 820, 839 
JCF.SeeJavaCollection Framework 
JCheckBox class, 839-844 
JCheckBox objects, 842 
JComboBox class, 847-850, 876 
JComboBox objects, 850 
J Component class, 943-944 
J Dialog class, 790 
J Dialog objects, 547 
J FileChooser class, 695, 729 
J FileChooser objects, 686-695, 771 
displaying, 689, 691 

J Frame class, 32, 44-47, 761, 793-796, 798, 
944-945 

creating subclasses of, 799, 807, 861-862 
J Frame objects, 32 
J Label class, 809,813,946 
J Label objects, 812 
J List class, 850-853,946-947 


J M enu objects, 857-858 
J M enuBar objects, 857 
J M enuFrame window, 857 
J M enultem objects, 857 
J NI. See J ava N ati ve I nterface 
JOptionPane class, 86, 213, 689, 790, 947-948 
J Panel class, 798 
subclasses of, 835 
J Panel objects, 829-830 
J RadioButton class, 844-847 
JScrollPane class, 819, 851,872 

adding scroll bars automatically, 819 
J Slider class, 853-856, 948-949 
J Slider objects, 853 
JTextArea class, 809 
JTextArea objects, 809, 814-815, 873 
JTextComponent class, 949-950 
JTextField class, 809-810 
JTextField objects, 809 
JVM , SeeJava Virtual M achines 

K 

Kanji characters, 498 
Key-value pairs, 606 
Keyboards, 5, 8 

Keyless entry system program, 477-491 
Korean, 498 

L 

Languages. See Programming languages 
LANs. See Local area networks 
Layout managers, 820-829 
and panels, 800 
Leap Year, computing, 297 
Length constants, of an array, 561, 591 
length method, of String objects, 58, 561 
Level, of nodes, 658 

Library Overdue Checker program, 418-436 
LibraryBook class, 419-427, 429, 434-435 
LibraryBook objects, 425 
LibraryCard class, 169 
LibraryCard objects, 169,171-172 
Life cycle, of software, 24-26 
Lightweight classes, 789 
Line separator, 816 
Linear searching, 634-635 
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Linked-node representation, 597 
LinkedList class, 597-598 
Listinterface, 597-598, 606 
Listeners, multiple, 803 
Lists, 596-605 

Literal constants, 100-101, 253 
Loan amount, computing, 131-129, 210-212 
Loan class, 199, 202-210,341-342 
Loan objects, 204-205 
Loan tables, 339-342 
L oanC alculator class, 199-210 
skeleton for, 203 

LoanCalculator program, 125-136, 340-342, 
367-371 

with an instantiable class, 198-213 
Local area networks (LANs), 4,10 
Local variables, 191-193 
Logical operators, 239 
long data type, 87-93, 97 
longM essageFormatflag, 243 
Loop-and-a-half repetition control, 323-326 
checklist for, 325 
Loop body, 304 
Loop counters, imprecise, 314 
Loop statements, 304 
infinite, 313-318 
nested, 341-342 
posttest, 319 
pretest, 319 

terminating, 322, 505, 767 
Loops 

improving user interface with, 306-308 
programming with, 309-310 
LotteryCard class, 188-190, 265 
Lovelace, Ada, 2 
Low-level file I/O, 695-699 

M 

M ac platform, 687 
M achinecode, 11 
M achine languages, 11 
M agnetic strip readers, 8 
M ain classes, 47 

changing any class to, 197-198 
main method, 32,198 
M aintenance, 25 


M ainWindow class, 761 
M ap interface, 606-607, 677 
Maps, 605-608 
MARK I, 3 
M arkers 
*/, 40, 404 
/*, 40 
/**, 404 
II, 40 

for comments, 40 
matching, 41 

Matcher class, 517-521, 535,544 
M atcher objects, 518, 545 
matches method, 510-515, 517-518 
M atching, pattern, 510-517 
M atching cases, 254-256 
MatchJ avaldentifier class, 513, 518 
M ath classes, 86, 113-117,126, 146, 295, 351, 
360, 364, 391-392,754,950 
methods for common mathematical functions, 
113-114 

M auchly, J ohn W., 3 
maxBottom method, 645 
maxChild method, 656 
M ealCard class, 443 
M egahertz (M Hz), 8 

Member accessibility, inheritance and, 744-749 
M emory 

allocation of, 89, 397,558, 581 
nonvolatile, 8 
volatile, 8 

M emory locations, 11 
M emory usage, 91 

varying with precision, 88 
M enus, 857-861 
M ergesort, 677, 900 
M essages, 18-20 
errors in, 52 
printing, 296 

sending, 18-20, 33,37-39 
syntax for, 37 
M ethod body, 47, 754 
M ethod composition, 56 
M ethod declarations, 47-48 
syntax for, 47 
method names, 47 
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M ethod prototype, 597 
M ethod signature, 388 
M ethods, 18-20 
abstract, 754 
calling, 37-38, 201-202 
overloaded, 386-391,440-441 
passing arrays to, 582-588 
passing objects to, 168-173 
recursive, 346-350 
returning an object from, 374-378 
reverse, 532 

of the same class, calling, 193-197 
shortening, 779 
value-returning, 157 
void, 156 

M etric conversion, 86 
M icrocomputers, 3 
MIDI devices, 8 
min methods, 392, 641-642 
M inicomputers, 3 

M inimalist approach, to running J ava 
programs, 12 

M inus (-) symbol, 182. See also Subtraction 
operators 

M obileRobot class, 180-181 
M odems, 10 
modifiers, 47-48 
accessibility, 156 
protected, 739, 744-749 
visibility, 180-181, 741 
M odulator-demodulator, 10 
M odulo arithmetic, 311 
division, 94 
M onitors, 5, 8 
M onogram class, 70 

program diagram for, 70, 86 
M onth objects, 627 

M ortgages, computing. See LoanCalculator program 
M otion type, selecting, 291-293 
motionStatus, 244 
M otorola PowerPC, 11 
M ouse, 5, 8 

movement of, 86 

M ouse events, handling, 861-869 
mouseClicked method, 865-867 
mouseD ragged method, 865-867 


M ouseEvent class, 862, 866 
M ouseM otionListener interface, 865 
M ultimedia information, viewing, 4 
M ultiple classes, defined and using, 162-166 
M ultiple constructors, 175, 389 
M ultiple listeners, 803 
M ultiple methods, 388 
M ultiple shapes, drawing, 293 
M ultiple stop conditions, 322 
M ultiplication operators, 96 
M usical instrument digital interface. See M IDI 
devices 

M usicCD objects, 384 
M utator methods, 158 
M y Documents folder, 689 
My First Subclass, 795 
M yFirst program, 30-39, 904-907 
M yM enuFrame class, 874 
myutil package, 402-403, 442-451 
myutil.Fraction class, 408-418 
M yWindow objects, 32-35, 38 

N 

NameComparator class, 673 
Named constants, 100, 253 
Names, displaying in reverse, 67 
Naming 

fully qualified, 44 

standard conventions for, 34, 46, 76, 78-79 
N ational I nstitutes of FI ealth, 529 
NCAA championship, 115 
Nested-for statements, 332-334 

rewriting as nested do-while statements, 364 
rewriting as nested while statements, 364 
Nested-if statements, 233-239 
controlling flow of, 233 
Nested loop statements, 341-342, 363 
Nested panels, effective use of, 830-839 
Nestings 

minimizing, 236 

showing structure clearly, 235-237 
Network interface cards (N ICs), 10 
Networks, 4 
Neumann, John von, 3 
new-line control character, 105 
new method, 500 
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new operator, 35, 250-251, 522, 557 
next method, 600, 706 
nextDouble method, 109, 706 
nextlnt method, 107, 706 
NICs. See Network interface cards 
Nodes 

left and right children of, 647 
level of, 658 
root, 646 

Noninteger indices, 605 

Nonvolatile memory, 8 

Normal case, 623 

Normalized fractions, 139 

NoSuchElementException class, 773 

NOT operators, 239-240 

Notation. See Asterisk notation; Dot notation; 

Exponential notation; Scientific notation; 

Shorthand notation 
null (reserved word), 170 
Null references, 575-576, 621 
Number systems, 6-7 
NumberFormatException error, 793 
N umbers. See also Standard deviation, computing 
arrays of, 578 

computing factorials of, 347-349 
computing greatest common divisor of, 899 
converting to Roman numerals, 298 
Fibonacci, 145, 367 
perfect, 366 
random, 119-120 
variables for, 90 
Numerator, 409-410 
Numeric promotion, 97 
Numerical data declaration, 91 
Numerical datatypes, 85-150 
key concepts, 140 

Numerical input values, getting, 107-112 
Numerical representation, 136-139 
Numerical values, displaying, 101-107 

O 

Object class, 749 
Object creation, 35-37 
syntax for, 35 

Object declaration, 33-34, 36, 91 
syntax for, 33 


Object diagrams, 127 
notation for, 35-36 
Object I/O, 709-716 

Object names, 79 .See also Identifiers; Naming 
Object-oriented programming (OOP), 12,15-28, 52 
basic concepts of, 16, 27 
power of, 342 

Object-oriented software engineering (OOSE), 955 
ObjectlnputStream objects, 710-711 
ObjectOutputStream objects, 709-710, 719 
Objects, 16-18,31 
arrays of, 567-577 
comparing, 247-252 
defined, 16 

erasing from memory, 576 
graphical representations of, 16 
passing to a method, 168-173 
referenced, 743 

returning from a method, 374-378 
saving, 712 
storing, 709-710 
variables for, 90 

Off-by-one errors (OBOEs), 315-316, 619 
Oldest person, finding, 570 
One-dimensional arrays, 589 
One-entry one-exit control flow, 325 
OOP. See Object-oriented programming 
OOSE. See Object-oriented software engineering 
openFile method, 538-540 
Operands, 95 
Operation phase, 25 
Operator overloading, 103 
Operators. See also Arithmetic operators; Boolean 
operators; Relational operators 
AND, 239-240,242 
addition, 96 
arithmetic, 94 
assignment, 98-99 
binary, 95, 97 
Boolean, 239-240 
decrement, 235 
division, 94 
increment, 235 
integer division, 94 
logical, 239 
multiplication, 96 
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Operators— Cont. 

NOT, 239-240 
OR, 239-240, 242 
precedence rules for B oolean, 243 
string concatenation, 59 
type cast, 97 

OR operators, 239-240, 242 
J ava symbols for, 242 
Ordering system, drive-through, 302 
Out-of-bound exceptions, 505 
outDataStream, 701 
outFile objects, 701 
outF ileStream, 701 
Output devices, 4-5, 8 

Output statements, 256. See also Temporary output 
statements 

Output values, 209-210 
design, 129-131 
test, 131 

OutputBox class, 766, 873, 876 
Outputs, 86,215-216 
file, 685-732 
formatting, 334-339 
making readable, 890 
outStream objects, 699 
OverdueChecker class, 420-421, 429-434 
OverdueChecker objects, 429 
Overflow, handling with enlarge method, 596 
Overflow errors, 314 

Overloaded constructors, 175, 386-391, 440 
Overloaded methods, 386-391, 440-441 
Overloading, operator, 103 

P 

Package visibility, 748 
Packages. See also J ava packages; javabook 
package 

classes grouped into, 43-44 
organizing classes into, 402-403 
programmer-defined, 909-910 
Pairwise comparisons, 643 
Palindromes, finding, 550 
Panels. See Nested panels 
@param tag, 405 
Parameters, 47-48,167 

matching with arguments, 166-168 


Parentheses, 96, 97 
partition method, 891-895 
Pascal (programming language), 12 
Pass-by-value scheme, 395-397, 400 
Passes, sorting, 639 
Passing arrays, to methods, 582-588 
Pattern class, 514, 517-521, 535, 544 
Pattern matching, and regular expression, 
510-517 

Pattern objects, 518, 545 
payScaleTablearray, 589-596 
PDA, Pocket PC, 790 
PDF format documents, 497 
Pentium 4, 8,11 
Extreme Edition, 9 
Perfect numbers, 366 
Periodic table, 177-185 
Person class, 567, 578, 662-663, 665-666, 

673. See also A ddressB ook program; 
AddressBook class 

Person objects, 568-569, 571, 576, 599-602 
adding to an array, 613, 617 
comparing, 659-679 
creating, 569 
reading, 724 
removing, 621, 623 
returning, 618 
saving, 710 

Pixel (picture element), 30 
playGame method, 353-359 
Plus (+) symbol, 182. See also Addition operators 
for concatenation of values, 102-103 
for string concatenation, 59 
Pocket PC PDA, 790 
Pointers, self-referencing, 379 
Polymorphic messages, 734 
polymorphic method, 736 
Polymorphism 
benefits of, 743 
defined, 734, 741-742 
inheritance and, 733-785 
using classes effectively with, 741-744 
Population growth, computing, 146-147 
Position values, 5-6 
Positioning. SeeAbsolute positioning 
Postcondition assertions, 474 
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Posttest loop, 319 
pow method, 126 
Precedence rules, 95-96, 242-243 
Precision 
higher, 87 

of real numbers, 314 
Precondition assertions, 474 
Predefined classes, 52, 272-273 
Pretest loop, 319 

Prices, printing out table of, 332-334, 366-367 
Prime N umberTheorem, 366 
Prime numbers, 366 
Priming read, 307 

Primitive data types, 92, 247-248, 521, 523, 527, 
602-605 

print method, 54, 101, 703, 761 
Printers, 5, 8 
printf method, 338 
Printing, echo, 64, 72, 128 
Printing initials program, 69-75 
printLine method, fine-tuning, 131 
println method, 55, 66, 101-102, 703, 761 
printout, 724 

printResult method, 763, 766-769 
printStackTrace method, 452, 469 
PrintWriter classes, 707 
PrintWriter objects, 703 
Private class constants, 182 
private methods, 156, 353, 357 
private (reserved word) modifier, 156,180-183, 
673, 739, 745-748, 757 

Problem statements, 69, 273, 351, 419, 533, 609, 
716, 760 

processData method, 762 
processinputData method, 490 
Program classes, 70, 274, 352, 761 
Program components, 39-49 
Program diagrams, 36, 41 
Program documentation, 41. See also Comments; 
Object diagrams; Programmers; User 
manuals 

Program implementation, 126 
sequence for, 126 
Program readability, 71, 226-228 
computing, 146 

Program review, 293, 625, 724, 779 


Program skeletons, 200-206, 275-277, 352-355, 
482-486, 536-538, 763-766 
with constructors, 610-612 
designs for, 200 

Program tasks, 70,125, 199, 273, 419, 534, 761 
Program templates, 48-49 
Program verification, 204 
Programmer-defined classes, 32,153,172, 

402-411 

Programmer-defined exceptions, 469-471 
Programmer-defined packages, 909-910 
Programmers 
client, 180 
work logs of, 496 

Programming, 24. See also Event-driven 

programming; Object-oriented programming 
computation, 86 
defensive, 256 
good style in, 128, 234-235 
incremental development, 86 
inputs, 86 

object-oriented, 15-28 
outputs, 86 
tasks comprising, 86 
Programming languages, 1-14 
classes of, 11-12 
Programs 

AddressBook, 716-724 

building word concordance, 533-546 

calculator, 877 

client, 180 

commercial, 41 

ComputeGrades, 759-779, 782 
drawing shapes, 272-293 
Eggy-Peggy (word game), 550, 552, 726 
EntranceM onitor, 481-482 
HiLo (game), 351-361 
keyless entry system, 477-491 
Library Overdue Checker, 418-436 
LoanCalculator, 125-136,198-213, 340-342, 
367-371 

MyFirstJava program, 30-39 
printing initials, 69-75 
RoomWinner, 264-266 
sorting AddressBook, 659-679 
terminating, 31 
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Project files, 50 
Promotion, 97 

Propagation, of exceptions, 458-466 
protected (reserved word) modifier, 739, 744-749 
Pseudocode representation, 340-342 
Pseudorandom number generator, 118 
Public class constants, 182,190-191 
Public-key cryptography, 553 
public methods, 156 

public (reserved word) modifier, 180-183, 267, 
673, 739, 745-748 
Punch cards, 2 

Punctuation, 503. See also individual marks of 
punctuation 

Pushbuttons, 799, 839, 845 

Q 

Quadratic equations, solving, 144 
Quicksort algorithms, 890-895 

R 

Radio buttons, 839, 844-845 
Radix, 6 

Random access memory (RAM ), 4, 7 
Random class, 86 
random method, 351, 359 
Random motion type, 291 
Random numbers, generating, 119-121 
Rank types, 271 
Read access, 686 
read method, 697, 722-724 
Read-only traversals, 602 
readData method, 762-779 
readDate method, 429 
readDoubles method, 429, 583-597 
readlntegers method, 585 
readLine method, 704 
readObject method, 711-712, 714 
readstring method, 429 
Real numbers 

data types for, 87-93 
in loop counters, 314-315 
representation of, 137-138 
Rebuild steps, 648-650 
sequences of, 649 
Rectangle, bounding, 263 


Recursion, 882-883 

basic elements of, 882-883 
defined, 346-347 

guidelines for using, 350, 895-897 
necessary components in, 348 
sequence of calls for, 349 
terminating, 348 
Recursive algorithms, 881-901 
Recursive methods, 346-350 
Reference data type, 92, 521 
Referenced objects, 743 
Registers, 8,11 
Regular expression 
defined, 511 

pattern matching and, 510-517 
Relational operators 

in boolean expressions, 223-224 
reversing, 239-240 
Relays, mechanical, 3 
remove method, 601 
Rentals 

computing charges for, 300 
tracking, 879-880 
Repetition control, 306 
checklist for, 320 
loop-and-a-half, 323-326 
Repetition statements, 222, 303-372 
defined, 304 
key concepts, 358 
pitfalls in writing, 313-318 
terminating, 505 

replaceAll method, 515-517, 523 
Reserved words, 38, 78 
reset method, 544 
Resident class, 477-479, 482 
Resident objects, 479, 494, 714 
return (reserved word) statements, 

158, 457 
syntax for, 158 
@ return tag, 405 
Return types, 47-48 
reverse method, 532 
Reversing relational operators, 239-240 
RGB color scheme, 260-261, 853-854 
RN A sequences, 531, 629 
Robot objects, 19-20,181 
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roll method, 186-187 

Roman numerals, converting numbers to, 298 
RoomWinner program, 264-266 
Root node, 646 
Root pane, 804 

roster arrays, 742-743, 764, 766-767, 771, 779, 
See also buildRoster method 
RSA cryptography system, 553-554 
Running J ava programs, 903-910 
Runtime exceptions, 460, 466 

S 

Sales, computing, 297, 302, 366 
Sample programs, see A ppendix B 
chapter-by-chapter list, 911-932 
saveFile method, 538-540 
Saving AddressBook objects, 716-724 
Saving J ava programs, 904-905 
Scanner class, 63-64, 71, 107-112, 309, 351, 
420-421, 529, 705-706, 792, 950-951 
Scanner objects, 556 
Scanning, 600, 625 
Scientific notation, 138-139 
scorePanel objects, 831 
Screensaver 
creating, 298 
simulating, 273 

Scroll bars, adding automatically, 819 
Search engines, Google, 533 
search method, implementation of, 618-621 
Searches, 634-638 
searchM inimum method, 582 
Second generation computers, 3 
Secondary storage devices, 8 
Selection statements, 221-302 
key concepts, 286 

selectionSort method, 640-642, 646 
Self-referencing pointers, 379 
Semicolons (;), 225 
Sentinel-controlled loops, 308 
Sequence diagrams, 957-958 
Sequential control flow, 222 
Sequential execution, 222 
Sequential searching, 635 
Serializable interface, 479. See also implements 
Serializable (phrase) 


Service providers, 199-200 
Set interface, 606, 629 
set methods, 158 

setBackground method, 261, 276, 797 
setBounds method, 827 
setCenterPoint method, 278 
setColumns method, 809 
setContent method, 836 
setC urrentD i rectory method, 690 
setData method, 653 
setDenominator method, 460 
setExchangeRate method. See Exchange rate, 
computing 

setFile method, 717-719 
setl nitial B alance method, 162,164 
setLayout method, 800 
setOwnerName method, 156,170-171 
setSize method, 800 
setupA rray method, 621, 625 
setVisible method, 38, 80, 276, 794 
Shapes 

drawing, 277-281 

selecting, 282-291 
Shipping cost, computing, 148-149 
Short-circuit evaluation, 242 
short data type, 87-93, 97, 254 
Shorthand assignment operator, 98 
Shorthand notation, 500-501 
showCloseDialog method, 691 
showDialog method, 693 
showM essageDialog method, 57, 213, 790-791 
showOpenDialog method, 689-690 
Sibling classes, 742 
Sign bits, 137 
Signature, method, 388 
Silicon chips, 3 

SimpleDateFormat class, 60-63,122, 335-336, 
423,951-952 

formatting symbols for, 62-63 
SimpleDateFormat objects, 61-62 
simplify method, 375-376, 378, 408, 410 
Simula (programming language), 12 
Single ampersand (&), 242 
Single-line comments, 40 
Single statements, syntax for, 226 
Single-task object(STO) principle, 609, 613, 697, 720 
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Single vertical bar (|), 242 
size method, 600 

Skeleton classes, 203. See also Program skeletons 
SketchPad class, 865-869 
sleep method, 258 
Slot machine simulation, 371 
Smalltalk (programming language), 12 
Smooth motion type, 291 
Software development, introduction to, 15-28 
Software engineering, and software life cycle, 24-26 
Software maintenance, 25 
sort method, 654, 667-668, 672-679 
sorted Li st array, 668 
SortedM ap interface, 605, 607 
Sorting, 633-683, 638-641 
Sorting AddressBook program, 659-679 
Sorting passes, 639 
Source code. See Programs 
Source files, 49 
compiling, 50-51 
Sources 

of inputs, 697 
of outputs, 695 
Special-purpose dialogs, 790 
Square brackets ([]), 557, 584 
Standard classes, 32, 52-68 
Standard conventions, for naming, 34, 46, 76, 78-79 
Standard deviation, computing, 627 
Standard input, 63-68 
Standard output, 53-55 

start method, 201, 280-281, 520, 536, 538-539 
State diagrams, 959-960 

State-of-memory diagrams, 35-36, 78, 90, 380-381, 
439-440, 548, 627 
stateC hanged method, 854 
Statements. See also A ssignment statements; I mport 
statements; Output statements; Problem 
statements 
for, 327-331 
branching, 224 
break, 254 
compound, 226 
control, 222 
do-while, 319-323 
if, 222-232 
if-then, 228 


if-then-else, 246 
import, 43-46, 78 
loop, 304 

nested-for, 332-334 
nested-if, 233-239 
repetition, 303-372 
selection, 221-302 
sequential execution of, 222 
single, 226 
switch, 252-256 
while, 304-313 
writing assignment, 101 
static blocks, 663 
Static initializer, 394 

static (reserved word) modifier, 185, 267, 392, 757 
Stationary motion type, 291 
STO. See Single-task object principle 
STOP (word), 505, 512,526 
Stop conditions, multiple, 322 
Storage devices, 4, 8-10 
Stored-program scheme, 3 
Stream objects, 697 
String argument, 270, 689, 772 
String class, 55-60, 70, 248, 338, 420, 499-502, 
510, 517,523,952-953 
defined, 55-56, 499 
String concatenation, 59, 527 
String objects, 56-57,168, 247-251, 270, 514, 
521-523,533, 581,848 
comparing, 247-248, 507 
methods for, 561 
String processing, 86 

and bioinformatics, 529-532 
StringBuffer class, 524-528, 532, 549, 953-954 
StringBuffer objects, 524-528, 547 
limits on, 525-526 
StringBuilder class, 524 
Strings, 499-510 

comparing, 507, 521-523 
manipulating contents of, 499-500, 524 
printing in reverse, 509 
StringTokenizer class, 535 
StringTokenizer objects, 772-773 
Structural constraints, 647, 659 
Stub methods, 202, 427 
stub build method, 542 
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Student class, 738-743, 752-761, 770-773 
Student object, 167,171-172 
Subarrays, 594 
Subclasses, 23, 735, 745-748 

extending their superclasses, 739-740 
Subexpressions, 95 
typecasting, 97 

substring method, 56-58, 73-74, 507, 523 
Subtraction operators, 94, 298 
Successful searches, 634 
Sun M icrosystems, 12, 903-904 
Superclasses, 23, 735, 741-742, 745-749 
abstract, 753-757 
defined, 752 

explicit calls to constructor of, 752 
extending, 739 
swap method, 398-399, 656 
Swing classes, 788-790 

Swing components, class hierarchy for, 935-936 
switch statements, 252-256, 296, 323, 454 
case labels for, 269-270 
controlling flow of, 255, 295 
making readable, 256 
mapping, 253 
syntax for, 253 
Switches, toggle, 872 
Symbolic constants, 100 
Syntax rules, violations of, 51 
System class, 32, 816 
System.exit statement, significance of, 908 
System.in, 64, 86,108, 125,705 
System.out, 53-55, 64, 86, 125,128, 134, 213, 338, 
351,459, 542,851 

T 

tab control character, 105 

Tables, 332-334. See also Two-dimensional arrays 
formatting, 589-590 
Tasks. See Program tasks 
TeachA rithmeticFrame class, 875-880 
Temperature conversion, computing, 142-143 
Temporary output statements, 202, 226, 764 
lOBaseT, 10 

Test output statements, 206 
TestAddressBookWrite, 721, 723 
TestCalendar program, 121-122 


TestDataOutputStream, 701 
testDelete method, 625 
Tester class, 395 
Testing phase, 25 
duplicate tests, 322 
never skipping, 136 
posttest loop, 319 
pretest loop, 319 
priming read in, 307 
testPrint method, 656 
TestPrintWriter, 704 
TestRandom class, 360-361 
Tests, avoidable, 316-317 
testSearch method, 621 
Text, drawing on the Graphics context, 293 
Text editors, 709 

Text files, 702-703, 726, 759-760 
Text-related GUI components, 809-810 
TextHandler class, 810 
Then blocks, 224-228 
rules for writing, 228 
Thesaurus class, 629 
Third generation computers, 3 
this (reserved word), 378-386, 796 
calling a constructor with, 185 
Throw statements, 454 
Throwable class, 451-452, 454, 466-467 
Throwing exceptions, 453-458 
Thrown exceptions, 446, 460 
throws (clause), 467-468, 471 
throwsException (clause), 460 
Tic Tac Toe program, 830 
TicTacToeCell class, 835-837 
TicTacToePanel class, 831, 835-839 
Toggle switches, 872 
Tokens, 772-773 
Top-down development, 199 
toString method, 60,170-171, 423, 427 
toU pperCase method, 502-503 
Tower of Hanoi puzzle, 888-890, 895 
Transcription, of DNA, 531 
Transistors, 3 
Traversals, 600 
read-only, 602 
TreeM ap class, 605-608 
TreeM ap objects, 607 
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Triangular arrays, 594 
Trigonometric functions. See M ath classes 
true (logical value), 93 
true (reserved word), 38 
Truth table, illustrating DeM organ's law, 241 
try-catch blocks, 449-450, 540, 771 
try-catch control statements, 449-450, 454-456, 
467-468, 471 
try statements, 258 

Turtle objects, 81-82,149-150, 219-220 
Two-dimensional arrays, 589-596 
Twos-complementformat, 136 
Type cast operators, 97 
Type safety, 268 
type variable, 283 
Typecasting, 96-97, 714 
syntax for, 97 

U 

UM L (Unified M odeling Language), 16, 955-962 
program diagrams in, 35, 955-956 
UndergraduateStudent class, 738-743, 752-761, 
770-774 

U nicode Worldwide Character Standard, 498, 
506-507 

lexicographical order of, 507 
U nified M odeling Language. See U M L 
Unit testing, 25 
UNIX platform, 687 
U nknown classes, dealing with, 273 
U nnormalized fractions, 139 
Unrelated classes, 737-738 
Unsuccessful searches, 634 
U ,S. D epartment of E nergy, 529 
U.S.Navy, 3 

Use case diagrams, 956-957 

useD elimiter method, 66 

User interface, improving with a loop, 306-308 

User manuals, 41 

V 

Vacuum tubes, 3 

Value relationship constraints, 647, 659 
Value-returning method, 157 
valueOf method, 83, 270 


Variable declarations, syntax for, 87 
Variable-pitch fonts, 809 
Variable-size array declarations, 566 
Variables, 21-22, 86-93 

assigning value to multiple, 99 
boolean, 239-247 
class, 23 
control, 327-328 
incrementing, 235 
initializing, 88-93 
instance, 23 
for numbers, 90 
for objects, 90 
properties of, 87 
Vector class, 598 
Vignere cipher, 553 
Visibility modifier, 180-183, 741 
void method, 156 
Volatile memory, 8 

W 

Wages, computing, 297 

WANs. See Wide area networks 

Watermelons. See Gravitational constant 

Web browsers, 4 

Web programming languages, 12 

Weight, recommended, computing, 218, 297 

while loops, 353, 358, 767 

while statements, 304-313 

advantage over do-while statements, 321, 503-504 

controlling flow of, 305 

rewriting as do-while statements, 323 

syntax for, 304 

writing, 363 

Wide area networks (WANs), 4 
Windows, DrawingBoard, 277 
Windows platform, 687 
Wireless networking (WiFi), 10 
Word concordances, 533 
building, 533-546 
Word guessing game, 551-552 
WordConcordance class, 535-537, 541-545 
WordList class, 533-534, 543, 546, 608 
WordList objects, 533-534, 543-544 
Wrapper classes, 603 
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Write access, 686 

write method, 720-722 

writeObject method, 713-714 

Writing computer programs. See Programming 

Writing repetition statements, pitfalls in, 313-318 

X 

Xerox PARC, 12 


Y 

Youngest person, finding, 570 

Z 

Zero, duplicate representations for, 137-139 
Zero-based indexing, 558, 566 
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An Introduction to Object-Oriented Programming with Java™, Fifth Edition takes a full-immersion 
approach to object-oriented programming. Proper object-oriented design practices are emphasized 
throughout the book. Students learn how to use the standard classes first, then learn to design 
their own classes. Wu continues to use a gentler approach to teaching students how to design their 
own classes, separating the coverage into two chapters. 

Outstanding Features: 

• Standard Java classes, such as the Scanner class and the GregorianCalendar class, are used 
effectively to enhance the learning of object-oriented programming. 

• Incremental Program Development is taught consistently throughout the book using Sample 
Development programs that are located at the end of Chapters 2 through 13. These longer 
programs walk students step-by-step through the stages of program development: design, 
coding, and testing. 

• Diagrams are used extensively to provide crystal clear illustration of core concepts considered 
difficult and often misunderstood by many beginners. 

• Student-Friendly Pedagogy provides students with tips, pitfalls to avoid, design guidelines, 
review questions, interesting facts, and more. Additionally, the author has incorporated a 
variety of examples with an eye to making them interesting for students. 

New to the Fifth Edition: 

• Level-by-level Programming Exercises provided at the end of each chapter and organized into 
three levels of difficulty. 

• More examples from the natural sciences are provided in several key chapters. 

• The Scanner class is used exclusively for getting inputs. The JOptionPane class is no longer 
used, except when it is introduced in Chapter 14 on GUI programming. 

The book is supported by a rich array of supplements available through the text’s website: 
www.mhhe.com/wu 

For students, source code for all example programs, answers to Quick Check exercises, and other 
resources are provided. 

For instructors, a complete set of PowerPoints, solutions to the chapter exercises, and other 
resources are provided. 
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This text is offered through CourseSmart for both instructors and students. CourseSmart is an 
online resource where students can purchase the complete text online at almost half the cost of a 
traditional text. Purchasing the eTextbook allows students to take advantage of CourseSmart’s web 
tools for learning, which include full text search, notes and highlighting, and email tools for sharing 
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